mcphub

MCPHub：您的终极 MCP 服务器中心

MCPHub 是一个统一的管理平台，它将多个 MCP（模型上下文协议）服务器按组聚合到单独的可流式传输 HTTP (SSE) 端点，以适应不同的场景。它通过直观的界面和强大的协议处理功能，简化您的 AI 工具集成。

🚀 功能

开箱即用的 MCP 服务器支持：无缝集成流行的服务器，如amap-maps 、 playwright 、 fetch 、 slack等。
集中式仪表板：从一个简洁的 Web UI 监控实时状态和性能指标。
灵活的协议处理：与 stdio 和 SSE MCP 协议完全兼容。
热插拔配置：动态添加、删除或更新 MCP 服务器 — 无需停机。
基于组的访问控制：将服务器组织成可定制的组，以简化权限管理。
安全身份验证：内置用户管理，具有由 JWT 和 bcrypt 支持的基于角色的访问。
Docker-Ready ：使用我们的容器化设置立即部署。

🔧 快速入门

可选配置

创建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 部署

访问仪表板

打开http://localhost:3000并使用您的凭据登录。

注意：默认凭据是admin / admin123 。

仪表板概述：

所有 MCP 服务器的实时状态
启用/禁用或重新配置服务器
用于组织服务器的组管理
用于访问控制的用户管理

可流式传输的 HTTP 端点

截至目前，不同的 AI 客户端对流式 HTTP 端点的支持有所不同。如果您遇到问题，可以使用 SSE 端点或等待后续更新。

通过以下方式连接 AI 客户端（例如 Claude Desktop、Cursor、DeepChat 等）：

http://localhost:3000/mcp

此端点为您的所有 MCP 服务器提供统一的可流式传输的 HTTP 接口。它允许您：

向任何已配置的 MCP 服务器发送请求
实时接收回复
轻松与各种AI客户端和工具集成
对所有服务器使用相同的端点，简化集成过程

特定组端点（推荐） ：

对于特定服务器组的目标访问，请使用基于组的 HTTP 端点：

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

其中{group}是您在信息中心中创建的组的 ID 或名称。这允许您：

连接到按用例组织的特定 MCP 服务器子集
隔离不同的AI工具以仅访问相关服务器
针对不同的环境或团队实施更细粒度的访问控制

SSE 端点（未来将弃用）

通过以下方式连接 AI 客户端（例如 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

这将以热重载的方式在开发模式下启动前端和后端。

对于 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