mcphub

MCPHub: ваш главный серверный концентратор MCP

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

MCPHub — это унифицированная платформа управления, которая объединяет несколько серверов MCP (Model Context Protocol) в отдельные конечные точки Streamable HTTP (SSE) для различных сценариев по группам. Она оптимизирует интеграцию инструментов ИИ с помощью интуитивно понятного интерфейса и надежной обработки протоколов.

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

Встроенная поддержка сервера MCP : беспроблемная интеграция популярных серверов, таких как amap-maps , playwright , fetch , slack и других.
Централизованная панель управления : отслеживайте состояние и показатели производительности в режиме реального времени с помощью единого удобного веб-интерфейса.
Гибкая обработка протоколов : полная совместимость с протоколами stdio и SSE MCP.
Конфигурация с возможностью «горячей» замены : добавляйте, удаляйте или обновляйте серверы MCP «на лету» — без простоев.
Групповой контроль доступа : организуйте серверы в настраиваемые группы для упрощенного управления разрешениями.
Безопасная аутентификация : встроенное управление пользователями с доступом на основе ролей на основе JWT и bcrypt.
Готовность к Docker : мгновенное развертывание с помощью нашей контейнерной конфигурации.

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

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

Создайте файл 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"
      }
    }
  },
  "users": [
    {
      "username": "admin",
      "password": "$2b$10$Vt7krIvjNgyN67LXqly0uOcTpN0LI55cYRbcKC71pUDAP0nJ7RPa.",
      "isAdmin": true
    }
  ]
}

Примечание : учетные данные по умолчанию — admin / admin123 . Пароли надежно хешируются с помощью bcrypt. Сгенерируйте новый хеш с помощью:
npx bcryptjs your-password

Развертывание 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, организованному по варианту использования
Изолируйте различные инструменты ИИ, чтобы получить доступ только к соответствующим серверам
Реализуйте более детальный контроль доступа для различных сред или групп.

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

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

http://localhost:3000/sse

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

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

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

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

👥 Вклад

Ваши вклады приветствуются!

Новые функции и оптимизации
Улучшения документации
Отчеты об ошибках и исправления
Переводы и предложения

📄 Лицензия

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

mcphub

Integrations