Servidor MCP-Hub-MCP

Un servidor concentrador que se conecta y administra otros servidores MCP (Protocolo de contexto de modelo).

Descripción general

Este proyecto crea un servidor concentrador MCP que puede conectarse a otros servidores MCP, listar sus herramientas y ejecutarlas. Es especialmente útil para superar el límite de 40 herramientas MCP de Cursor. Incluso fuera de Cursor, ayuda a reducir los errores de la IA al ocultar las herramientas poco utilizadas.

Características principales

Conexión automática a otros servidores MCP mediante archivo de configuración
Lista de herramientas disponibles en los servidores conectados
Llamar a herramientas en servidores conectados y devolver resultados

Configuración

Añade esto a tu mcp.json :

Usando npx

{
  "mcpServers": {
    "mcp-hub": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-hub-mcp",
        "--config-path",
        "/path/to/your/mcp-hub-config.json"
      ]
    }
  }
}

Uso de Node (por ejemplo, para desarrollo local o ejecución directa)

Si npx no detecta los cambios locales o prefieres ejecutar directamente el servidor compilado, puedes configurarlo de esta manera:

{
  "mcpServers": {
    "mcp-hub": {
      "command": "node",
      "args": [
        "/path/to/your/mcp-hub-mcp/dist/index.js",
        "--config-path",
        "/path/to/your/mcp-hub-config.json"
      ]
    }
  }
}

Nota: asegúrese de haber compilado el proyecto (por ejemplo, npm run build o pnpm build ) para que dist/index.js exista.

Indicador del sistema (o reglas del cursor)

Before processing a user's request, you must use the "list_all_tools" command to identify which tools are available.

Esto garantiza que el asistente de IA siempre verificará las herramientas disponibles antes de intentar usarlas.

Instalación y funcionamiento

Requisitos

Node.js 18.0.0 o superior
npm, hilo o pnpm

Instalación

# Clone repository
git clone <repository-url>
cd mcp-hub-mcp

# Install dependencies
npm install
# or
yarn install
# or
pnpm install

Construir

npm run build
# or
yarn build
# or
pnpm build

Correr

npm start
# or
yarn start
# or
pnpm start

Modo de desarrollo

npm run dev
# or
yarn dev
# or
pnpm dev

Archivo de configuración

El servidor MCP-Hub-MCP utiliza un archivo de configuración en formato Claude Desktop para conectarse automáticamente a otros servidores MCP. Puede especificar el archivo de configuración de las siguientes maneras:

Variable de entorno: Establezca la variable de entorno MCP_CONFIG_PATH en la ruta del archivo de configuración
Argumento de la línea de comandos: utilice la opción --config-path para especificar la ruta del archivo de configuración
Ruta predeterminada: utilice el archivo mcp-config.json en el directorio actual

Formato del archivo de configuración:

{
  "mcpServers": {
    "serverName1": {
      "command": "command",
      "args": ["arg1", "arg2", ...],
      "env": { "ENV_VAR1": "value1", ... }
    },
    "serverName2": {
      "command": "anotherCommand",
      "args": ["arg1", "arg2", ...]
    }
  }
}

Ejemplo:

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/Users/username/Desktop",
        "/Users/username/Downloads"
      ]
    },
    "other-server": {
      "command": "node",
      "args": ["path/to/other-mcp-server.js"]
    }
  }
}

Uso

El servidor MCP-Hub-MCP proporciona las siguientes herramientas:

1. `list-all-tools`

Devuelve una lista de herramientas de todos los servidores conectados.

{
  "name": "list-all-tools",
  "arguments": {}
}

2. `call-tool`

Llama a una herramienta en un servidor específico.

serverName : Nombre del servidor MCP desde el que se llamará la herramienta
toolName : Nombre de la herramienta a llamar
toolArgs : Argumentos para pasar a la herramienta

{
  "name": "call-tool",
  "arguments": {
    "serverName": "filesystem",
    "toolName": "readFile",
    "toolArgs": {
      "path": "/Users/username/Desktop/example.txt"
    }
  }
}

Convención de mensajes de confirmación

Este proyecto sigue los Commits convencionales para el control de versiones automático y la generación de REGISTRO DE CAMBIOS.

Formato: <type>(<scope>): <description>

Ejemplos:

feat: add new hub connection feature
fix: resolve issue with server timeout
docs: update API documentation
chore: update dependencies

Tipos:

feat : Nueva característica (mejora de versión MENOR)
fix : Corrección de errores (actualización de la versión PATCH)
docs : Solo cambios en la documentación
style : Cambios que no afectan el significado del código
refactor : cambio de código que no corrige un error ni agrega una característica
perf : Cambio de código que mejora el rendimiento
test : Agregar pruebas faltantes o corregir pruebas existentes
chore : Cambios en el proceso de construcción o herramientas auxiliares

Cambios importantes: agregue BREAKING CHANGE: en el pie de página de la confirmación para activar un aumento de versión IMPORTANTE.

Pila tecnológica

Node.js
Mecanografiado
@modelcontextprotocol/sdk (versión: ^1.9.0)
zod (versión: ^3.22.4)

Licencia

Instituto Tecnológico de Massachusetts (MIT)

MCP-Hub-MCP Server

Integrations