MCPHub: унифицированный концентратор для серверов Model Context Protocol (MCP)

английский |中文版

MCPHub упрощает управление и масштабирование нескольких серверов MCP (Model Context Protocol), организуя их в гибкие конечные точки потокового HTTP (SSE), поддерживающие доступ ко всем серверам, отдельным серверам или логическим группам серверов.

🚀 Особенности

• Расширенная поддержка MCP-сервера : простая интеграция любого MCP-сервера с минимальной настройкой.

• Централизованная панель управления : отслеживайте состояние и показатели производительности в режиме реального времени с помощью единого удобного веб-интерфейса.

• Гибкая обработка протоколов : полная совместимость с протоколами stdio и SSE MCP.

• Конфигурация с возможностью «горячей» замены : добавляйте, удаляйте или обновляйте серверы MCP «на лету» — без простоев.

• Групповой контроль доступа : организуйте серверы в настраиваемые группы для упрощенного управления разрешениями.

• Безопасная аутентификация : встроенное управление пользователями с доступом на основе ролей на основе JWT и bcrypt.

• Готовность к Docker : мгновенное развертывание с помощью нашей контейнерной конфигурации.

Related MCP server: abstractapi-mcp-server

🔧 Быстрый старт

Дополнительная конфигурация

Создайте файл mcp_settings.json для настройки параметров вашего сервера:

{
  "mcpServers": {
    "amap": {
      "command": "npx",
      "args": ["-y", "@amap/amap-maps-mcp-server"],
      "env": {
        "AMAP_MAPS_API_KEY": "your-api-key"
      }
    },
    "playwright": {
      "command": "npx",
      "args": ["@playwright/mcp@latest", "--headless"]
    },
    "fetch": {
      "command": "uvx",
      "args": ["mcp-server-fetch"]
    },
    "slack": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-slack"],
      "env": {
        "SLACK_BOT_TOKEN": "your-bot-token",
        "SLACK_TEAM_ID": "your-team-id"
      }
    }
  }
}

Развертывание Docker

Рекомендуется : смонтировать свою пользовательскую конфигурацию:

docker run -p 3000:3000 -v $(pwd)/mcp_settings.json:/app/mcp_settings.json samanhappy/mcphub

или запустить с настройками по умолчанию:

docker run -p 3000:3000 samanhappy/mcphub

Доступ к панели инструментов

Откройте http://localhost:3000 и войдите в систему, используя свои учетные данные.

Примечание : учетные данные по умолчанию: admin / admin123 .

Обзор панели инструментов :

• Текущий статус всех серверов MCP

• Включение/отключение или перенастройка серверов

• Групповое управление для организации серверов

• Администрирование пользователей для контроля доступа

Конечная точка HTTP для потоковой передачи

На данный момент поддержка потоковых конечных точек HTTP различается в разных клиентах AI. Если у вас возникнут проблемы, вы можете использовать конечную точку SSE или подождать будущих обновлений.

Подключите клиенты ИИ (например, Claude Desktop, Cursor, DeepChat и т. д.) через:

http://localhost:3000/mcp

Эта конечная точка обеспечивает унифицированный потоковый HTTP-интерфейс для всех ваших серверов MCP. Она позволяет вам:

• Отправка запросов на любой настроенный сервер MCP

• Получайте ответы в режиме реального времени

• Простая интеграция с различными клиентами и инструментами ИИ

• Используйте одну и ту же конечную точку для всех серверов, что упрощает процесс интеграции.

Конечные точки, специфичные для группы (рекомендуется) :

Для целевого доступа к определенным группам серверов используйте групповую конечную точку HTTP:

http://localhost:3000/mcp/{group}

Где {group} — это идентификатор или имя группы, которую вы создали на панели управления. Это позволяет вам:

• Подключитесь к определенному подмножеству серверов MCP, организованному по варианту использования

• Изолируйте различные инструменты ИИ, чтобы получить доступ только к соответствующим серверам

• Реализуйте более детальный контроль доступа для различных сред или групп.

Конечные точки, специфичные для сервера : для прямого доступа к отдельным серверам используйте конечную точку HTTP, специфичную для сервера:

http://localhost:3000/mcp/{server}

Где {server} — имя сервера, к которому вы хотите подключиться. Это позволяет вам напрямую получить доступ к определенному серверу MCP.

Примечание : если имя сервера и имя группы совпадают, приоритет будет иметь имя группы.

Конечная точка SSE (устареет в будущем)

Подключите клиенты ИИ (например, Claude Desktop, Cursor, DeepChat и т. д.) через:

http://localhost:3000/sse

Для целевого доступа к определенным группам серверов используйте групповую конечную точку SSE:

http://localhost:3000/sse/{group}

Для прямого доступа к отдельным серверам используйте конечную точку SSE для конкретного сервера:

http://localhost:3000/sse/{server}

🧑‍💻 Местное развитие

git clone https://github.com/samanhappy/mcphub.git
cd mcphub
pnpm install
pnpm dev

Это запускает как frontend, так и backend в режиме разработки с горячей перезагрузкой.

Пользователям Windows может потребоваться запустить внутренний сервер и внешний интерфейс по отдельности: pnpm backend:dev , pnpm frontend:dev .

🛠️ Распространенные проблемы

Использование Nginx в качестве обратного прокси-сервера

Если вы используете Nginx для обратного прокси-сервера MCPHub, обязательно добавьте следующую конфигурацию в настройки Nginx:

proxy_buffering off

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

• Бэкэнд : Node.js, Express, TypeScript

• Фронтенд : React, Vite, Tailwind CSS

• Аутентификация : JWT и bcrypt

• Протокол : Модель контекстного протокола SDK

👥 Вклад

Приветствуются любые вклады!

• Новые функции и оптимизации

• Улучшения документации

• Отчеты об ошибках и исправления

• Переводы и предложения

Добро пожаловать в наше сообщество Discord для обсуждений и поддержки.

❤️ Спонсор

Если вам нравится этот проект, возможно, вы могли бы рассмотреть:

🌟 История звезд

📄 Лицензия

Лицензировано по лицензии Apache 2.0 .