@traventia/mcp-proxy

Proxy que convierte el transporte stdio a HTTP/SSE para usar servidores MCP remotos con Claude Desktop.

Configuración en Claude Desktop

Edita el archivo de configuración de Claude Desktop:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

Ejemplo

{
  "mcpServers": {
    "mi-servidor": {
      "command": "npx",
      "args": ["-y", "@traventia/mcp-proxy"],
      "env": {
        "MCP_PROXY_URL": "https://mi-servidor.com/mcp",
        "MCP_PROXY_API_KEY": "tu-api-key"
      }
    }
  }
}

Múltiples servidores

Puedes configurar varios proxies apuntando a diferentes servidores:

{
  "mcpServers": {
    "servidor-produccion": {
      "command": "npx",
      "args": ["-y", "@traventia/mcp-proxy"],
      "env": {
        "MCP_PROXY_URL": "https://prod.example.com/mcp",
        "MCP_PROXY_API_KEY": "sk-prod-key"
      }
    },
    "servidor-desarrollo": {
      "command": "npx",
      "args": ["-y", "@traventia/mcp-proxy"],
      "env": {
        "MCP_PROXY_URL": "https://dev.example.com/mcp",
        "MCP_PROXY_API_KEY": "sk-dev-key"
      }
    }
  }
}

Variables de entorno

| Variable | Requerida | Descripción | |----------|-----------|-------------| | MCP_PROXY_URL | Sí | URL del servidor MCP remoto | | MCP_PROXY_API_KEY | No | API Key para autenticación Bearer |

Cómo funciona

1. Claude Desktop inicia el proxy como proceso hijo con comunicación stdio
2. El proxy recibe mensajes JSON-RPC por stdin
3. Envía las peticiones al servidor MCP remoto vía HTTP POST
4. Maneja respuestas JSON y SSE (Server-Sent Events)
5. Devuelve las respuestas a Claude Desktop por stdout

Licencia

MIT