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)

# 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

# 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

# 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)

# 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)

{
  "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

cd client/
npm install

2. Publicar

# 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:

// 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:

{
  "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.