MCP-концентратор-MCP-сервер

Концентрационный сервер, который подключается к другим серверам MCP (Model Context Protocol) и управляет ими.

Обзор

Этот проект создает сервер-концентратор MCP, который может подключаться к другим серверам MCP, перечислять их инструменты и выполнять их. Он особенно полезен для обхода ограничения MCP Cursor на 40 инструментов. Даже за пределами Cursor он помогает сократить ошибки ИИ, скрывая редко используемые инструменты.

Related MCP server: Resource Hub Server

Основные характеристики

• Автоматическое подключение к другим серверам MCP через файл конфигурации

• Список доступных инструментов на подключенных серверах

• Вызов инструментов на подключенных серверах и возврат результатов

Конфигурация

Добавьте это в ваш mcp.json :

Использование npx

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

Использование Node (например, для локальной разработки или прямого выполнения)

Если npx не принимает ваши локальные изменения или вы предпочитаете запускать собранный сервер напрямую, вы можете настроить его следующим образом:

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

Примечание: Убедитесь, что вы выполнили сборку проекта (например, npm run build или pnpm build ), чтобы существовал dist/index.js .

Системная подсказка (или правила курсора)

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

Это гарантирует, что помощник на основе искусственного интеллекта всегда будет проверять доступные инструменты, прежде чем пытаться их использовать.

Установка и запуск

Требования

• Node.js 18.0.0 или выше

• npm, пряжа или pnpm

Установка

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

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

Строить

npm run build
# or
yarn build
# or
pnpm build

Бегать

npm start
# or
yarn start
# or
pnpm start

Режим разработки

npm run dev
# or
yarn dev
# or
pnpm dev

Файл конфигурации

Сервер MCP-Hub-MCP использует файл конфигурации формата Claude Desktop для автоматического подключения к другим серверам MCP. Вы можете указать файл конфигурации следующими способами:

1. Переменная среды: задайте переменную среды MCP_CONFIG_PATH на путь к файлу конфигурации.

2. Аргумент командной строки: используйте параметр --config-path чтобы указать путь к файлу конфигурации.

3. Путь по умолчанию: использовать файл mcp-config.json в текущем каталоге.

Формат файла конфигурации:

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

Пример:

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

Использование

Сервер MCP-Hub-MCP предоставляет следующие инструменты:

1. list-all-tools

Возвращает список инструментов со всех подключенных серверов.

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

2. call-tool

Вызывает инструмент на определенном сервере.

• serverName : Имя сервера MCP, с которого будет вызываться инструмент.

• toolName : Имя инструмента для вызова

• toolArgs : Аргументы для передачи инструменту

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

Соглашение о фиксации сообщения

В этом проекте используются традиционные коммиты для автоматического управления версиями и генерации CHANGELOG.

Формат: <type>(<scope>): <description>

Примеры:

• feat: add new hub connection feature

• fix: resolve issue with server timeout

• docs: update API documentation

• chore: update dependencies

Типы:

• feat : Новая функция (увеличение версии Minor)

• fix : исправление ошибки (повышение версии PATCH)

• docs : Изменения только в документации

• style : Изменения, не влияющие на смысл кода.

• refactor : изменение кода, которое не исправляет ошибку и не добавляет функцию

• perf : Изменение кода, повышающее производительность

• test : Добавление отсутствующих тестов или исправление существующих тестов

• chore : изменения в процессе сборки или вспомогательных инструментах

Критические изменения: добавьте BREAKING CHANGE: в нижний колонтитул коммита, чтобы вызвать ОСНОВНОЕ обновление версии.

Технологический стек

• Node.js

• Машинопись

• @modelcontextprotocol/sdk (версия: ^1.9.0)

• зод (версия: ^3.22.4)

Лицензия

Массачусетский технологический институт