Mcphub: Deploy Your Own MCP Servers In Minutes

🚀 MCPHub：您的终极 MCP 服务器中枢

MCPHub 是一个统一管理平台，它将多个 MCP（模型上下文协议）服务器整合到不同场景下的流式 HTTP（SSE）端点中，并按组分类。通过直观的界面和强大的协议处理能力，MCPHub 极大地简化了 AI 工具的集成过程。

🚀 快速开始

可选配置

您可以创建 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 并登录。

✨ 主要特性

• 开箱即用的 MCP 服务器支持：可无缝集成流行服务器，如 amap-maps、playwright、fetch、slack 等。
• 集中式控制台：能从一个简洁的网络界面实时监控状态和性能指标。
• 灵活的协议处理：全面兼容 stdio 和 SSE MCP 协议。
• 热插拔配置：可随时添加、删除或更新 MCP 服务器，无需停机。
• 基于组的访问控制：能将服务器组织到自定义组中，简化权限管理。
• 安全认证：内置用户管理，采用基于 JWT 和 bcrypt 的角色访问控制。
• Docker 就绪：支持使用容器化立即部署。

🛠️ 常见问题

使用 Nginx 作为反向代理

如果您使用 Nginx 作为 MCPHub 的反向代理，请确保在您的 Nginx 配置中添加以下内容：

proxy_buffering off

🔧 技术细节

• 后端：采用 Node.js、Express、TypeScript 构建。
• 前端：使用 React、Vite、Tailwind CSS 开发。
• 认证：运用 JWT 和 bcrypt 进行身份验证。
• 协议：使用模型上下文协议 SDK。

👥 贡献

欢迎大家参与贡献！具体可从以下方面入手：

• 新功能开发及优化
• 文档改进
• 错误报告及修复
• 翻译及建议

📄 许可证

本项目遵循 Apache 2.0 许可证。