MCPHub：一站式 MCP 服务器聚合平台

English | Français | 中文版

MCPHub 通过将多个 MCP（Model Context Protocol）服务器组织为灵活的流式 HTTP（SSE）端点，简化了管理与扩展工作。系统支持按需访问全部服务器、单个服务器或按场景分组的服务器集合。

🌐 在线文档与演示

• 文档地址: docs.mcphub.app
• 演示环境: demo.mcphub.app

🚀 功能亮点

• 集中式管理 - 在统一控制台中监控和管理所有 MCP 服务器
• 灵活路由 - 通过 HTTP/SSE 访问所有服务器、特定分组或单个服务器
• 智能路由 - 基于向量语义搜索的 AI 工具发现 (了解更多)
• 热插拔配置 - 无需停机即可添加、移除或更新服务器
• OAuth 2.0 支持 - 客户端和服务端模式，实现安全认证 (了解更多)
• 社交一键登录 - 通过 Better Auth 集成支持 GitHub 和 Google 快捷登录（需启用数据库模式）
• 数据库模式 - 将配置存储在 PostgreSQL 中，适用于生产环境 (了解更多)
• Docker 就绪 - 容器化部署，开箱即用

🔧 快速开始

配置

创建 mcp_settings.json 文件：

{
  "mcpServers": {
    "time": {
      "command": "npx",
      "args": ["-y", "time-mcp"]
    },
    "fetch": {
      "command": "uvx",
      "args": ["mcp-server-fetch"]
    }
  }
}

📖 查看配置指南了解完整选项，包括 OAuth、环境变量等。

Docker 部署

# 挂载自定义配置运行（推荐）
docker run -p 3000:3000 -v ./mcp_settings.json:/app/mcp_settings.json -v ./data:/app/data samanhappy/mcphub

# 或使用默认配置运行
docker run -p 3000:3000 samanhappy/mcphub

访问控制台

打开 http://localhost:3000，使用用户名 admin 登录。首次启动时，如果未设置 ADMIN_PASSWORD 环境变量，系统将自动生成随机密码并输出到服务器日志中。也可以预先设置密码：

# Docker：通过环境变量设置管理员密码
docker run -p 3000:3000 -e ADMIN_PASSWORD=your-secure-password samanhappy/mcphub

提示： 首次登录后请及时修改管理员密码以确保安全。

连接 AI 客户端

通过以下地址连接 AI 客户端（Claude Desktop、Cursor 等）：

http://localhost:3000/mcp           # 所有服务器
http://localhost:3000/mcp/{group}   # 特定分组
http://localhost:3000/mcp/{server}  # 特定服务器
http://localhost:3000/mcp/$smart    # 智能路由
http://localhost:3000/mcp/$smart/{group}  # 智能路由（特定分组）

安全提示：MCP 端点默认需要身份验证，以避免意外暴露。若需对 MCP 端点开放匿名访问，请在密钥设置中关闭 启用 Bearer 认证。免登录开关仅影响仪表盘登录。仅建议在受信任环境中使用。

📖 查看 API 参考了解详细的端点文档。

📚 文档

| 主题 | 描述 | | ------------------------------------------------------------------------------ | ---------------------------- | | 快速开始 | 5 分钟快速上手 | | 配置指南 | MCP 服务器配置选项 | | 数据库模式 | PostgreSQL 生产环境配置 | | OAuth | OAuth 2.0 客户端和服务端配置 | | 智能路由 | AI 驱动的工具发现 | | Docker 部署 | Docker 部署指南 |

🧑‍💻 本地开发

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

Windows 用户需分别启动后端和前端：pnpm backend:dev，pnpm frontend:dev

📖 查看开发指南了解详细设置说明。

🔍 技术栈

• 后端：Node.js、Express、TypeScript
• 前端：React、Vite、Tailwind CSS
• 认证：JWT & bcrypt
• 协议：Model Context Protocol SDK

👥 贡献指南

欢迎加入企微交流共建群，由于群人数限制，有兴趣的同学可以扫码添加管理员为好友后拉入群聊。

如果觉得项目有帮助，不妨请我喝杯咖啡 ☕️

致谢

感谢以下朋友的赞赏：小白、唐秀川、琛、孔、黄祥取、兰军飞、无名之辈、Kyle，以及其他匿名支持者。

🌟 Star 历史趋势

📄 许可证

本项目采用 Apache 2.0 许可证。