hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Servidor proxy MCP

Un servidor proxy MCP que agrupa y sirve a múltiples servidores de recursos MCP a través de una única interfaz. Este servidor actúa como un concentrador central que puede:

Conectarse y administrar múltiples servidores de recursos MCP
Exponer sus capacidades combinadas a través de una interfaz unificada
Gestionar el enrutamiento de solicitudes a los servidores backend apropiados
Respuestas agregadas de múltiples fuentes

Características

Gestión de recursos

Descubra y conéctese a múltiples servidores de recursos MCP
Agregar recursos de todos los servidores conectados
Mantener esquemas de URI consistentes en todos los servidores
Gestionar el enrutamiento y la resolución de recursos

Agregación de herramientas

Exponer herramientas de todos los servidores conectados
Enrutar las llamadas a la herramienta a los servidores backend apropiados
Mantener el estado de la herramienta y gestionar las respuestas

Manejo rápido

Mensajes agregados de todos los servidores conectados
Enrutar solicitudes rápidas a los backends apropiados
Gestionar respuestas de avisos de múltiples servidores

Configuración

El servidor requiere un archivo de configuración JSON que especifica los servidores MCP a los que se conectará. Copie la configuración de ejemplo y modifíquela según sus necesidades:

cp config.example.json config.json

Ejemplo de estructura de configuración:

{
  "servers": [
    {
      "name": "Server 1",
      "transport": {
        "command": "/path/to/server1/build/index.js"
      }
    },
    {
      "name": "Server 2",
      "transport": {
        "command": "server2-command",
        "args": ["--option1", "value1"],
        "env": ["SECRET_API_KEY"]
      }
    },
    {
      "name": "Example Server 3",
      "transport": {
        "type": "sse",
        "url": "http://localhost:8080/sse"
      }
    }
  ]
}

El archivo de configuración debe proporcionarse al ejecutar el servidor:

MCP_CONFIG_PATH=./config.json mcp-proxy-server

Desarrollo

Instalar dependencias:

npm install

Construir el servidor:

npm run build

Para desarrollo con reconstrucción automática:

npm run watch

Para desarrollo con ejecución continua:

# Stdio
npm run dev
# SSE
npm run dev:sse

Instalación

Para utilizar con Claude Desktop, agregue la configuración del servidor:

En MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json En Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "mcp-proxy": {
      "command": "/path/to/mcp-proxy-server/build/index.js",
      "env": {
        "MCP_CONFIG_PATH": "/absolute/path/to/your/config.json",
        "KEEP_SERVER_OPEN": "1"
      }
    }
  }
}

KEEP_SERVER_OPEN mantendrá el SSE en funcionamiento incluso si un cliente se desconecta. Resulta útil cuando varios clientes se conectan al proxy MCP.

Depuración

Dado que los servidores MCP se comunican a través de stdio, la depuración puede ser complicada. Recomendamos usar el Inspector MCP , disponible como script de paquete:

npm run inspector

El Inspector proporcionará una URL para acceder a las herramientas de depuración en su navegador.

You must be authenticated.

A

security – no known vulnerabilities

A

license - permissive license

A

quality - confirmed to work

Un centro central que agrega múltiples servidores de recursos MCP en una única interfaz unificada, lo que permite a los usuarios acceder a herramientas y capacidades desde múltiples servidores back-end a través de un punto de conexión.

Related Resources

Reddit Discussion about this server

MCP Proxy Server