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.

Related MCP server: MCP Server

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": {
    "other-tools": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-hub-mcp",
        "--config-path",
        "/Users/username/mcp.json"
      ]
    }
  }
}

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:

1. Variable de entorno: Establezca la variable de entorno MCP_CONFIG_PATH en la ruta del archivo de configuración

2. Argumento de la línea de comandos: utilice la opción --config-path para especificar la ruta del archivo de configuración

3. 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)