npm package: @gomonke/mcp-cartera-client
Description: Cliente MCP para conexión remota a servidor de cartera
Author: Gomonke
Latest version: 1.0.1

# Cliente MCP para Cartera

Cliente ligero para conectar Claude Desktop a un servidor MCP remoto.

## 🎯 Propósito

Este paquete permite que **cualquier máquina** con Claude Desktop se conecte al servidor MCP de cartera **sin necesidad de tener el código del servidor**.

## 📦 Opciones de Distribución

### Opción 1: Publicar a npm (Recomendado para producción)

```bash
# 1. Desde el directorio client/
npm publish --access public

# 2. En cualquier máquina, configurar Claude Desktop:
{
  "mcpServers": {
    "cartera": {
      "command": "npx",
      "args": ["-y", "@tu-empresa/mcp-cartera-client@latest"],
      "env": {
        "MCP_SERVER_URL": "http://tu-servidor:3000"
      }
    }
  }
}
```

### Opción 2: Usar desde GitHub

```bash
# 1. Subir a GitHub

# 2. Configurar Claude Desktop:
{
  "mcpServers": {
    "cartera": {
      "command": "npx",
      "args": [
        "-y",
        "github:tu-usuario/mcp-cartera#main",
        "--prefix",
        "client"
      ],
      "env": {
        "MCP_SERVER_URL": "http://tu-servidor:3000"
      }
    }
  }
}
```

### Opción 3: Instalar globalmente

```bash
# 1. Desde el directorio client/
npm install -g .

# 2. Configurar Claude Desktop:
{
  "mcpServers": {
    "cartera": {
      "command": "mcp-cartera",
      "args": [],
      "env": {
        "MCP_SERVER_URL": "http://tu-servidor:3000"
      }
    }
  }
}
```

### Opción 4: Usar ruta local (para desarrollo)

```bash
# Configurar Claude Desktop:
{
  "mcpServers": {
    "cartera": {
      "command": "node",
      "args": ["/ruta/al/proyecto/client/index.js"],
      "env": {
        "MCP_SERVER_URL": "http://localhost:3000"
      }
    }
  }
}
```

## 🔧 Configuración

### Variables de Entorno

**MCP_SERVER_URL** (requerido): URL del servidor MCP remoto

Ejemplos:
- Servidor local: `http://localhost:3000`
- IP en red local: `http://192.168.1.100:3000`
- Dominio: `https://mcp.tuempresa.com`

## 📝 Configuración Completa de Claude Desktop

**Archivo:** `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS)

```json
{
  "mcpServers": {
    "cartera": {
      "command": "npx",
      "args": ["-y", "@tu-empresa/mcp-cartera-client@latest"],
      "env": {
        "MCP_SERVER_URL": "https://mcp.tuempresa.com"
      }
    }
  }
}
```

## ✅ Ventajas

- ✅ **Sin código en las máquinas cliente**: Solo se necesita la URL del servidor
- ✅ **Actualización centralizada**: Cambios solo en el servidor
- ✅ **Fácil distribución**: `npx` instala automáticamente
- ✅ **Múltiples clientes**: Cualquier máquina puede conectarse

## 🚀 Para Distribuir

### 1. Preparar para npm

```bash
cd client/
npm install
```

### 2. Publicar

```bash
# Login a npm
npm login

# Publicar (cambiar nombre en package.json primero)
npm publish --access public
```

### 3. Usar en otras máquinas

Solo necesitan:
1. Claude Desktop instalado
2. Agregar la configuración JSON
3. Reiniciar Claude Desktop

## 🔒 Seguridad

Si el servidor MCP requiere autenticación:

```javascript
// En client/index.js, agregar header:
const response = await fetch(url, {
  ...options,
  headers: {
    'Content-Type': 'application/json',
    'Authorization': `Bearer ${process.env.MCP_API_KEY}`,
    ...options.headers
  }
});
```

Y en Claude Desktop:
```json
{
  "env": {
    "MCP_SERVER_URL": "https://mcp.tuempresa.com",
    "MCP_API_KEY": "tu_api_key_secreta"
  }
}
```

## 📚 Más Información

Ver documentación completa en el proyecto principal.