Mcphub: Deploy Your Own Mcp Servers In Minutes

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

MCPHub 是一个统一管理平台，它能将多个 MCP（模型上下文协议）服务器整合到不同场景下的流式 HTTP（SSE）端点中，并按组进行分类。借助直观的界面和强大的协议处理能力，它极大地简化了 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

🔧 技术细节

技术栈

👥 贡献

欢迎大家参与贡献！您可以在以下方面进行贡献：

• 新功能开发及性能优化
• 文档内容改进
• 错误报告及修复
• 翻译工作及提供建议

📄 许可证

本项目遵循 Apache 2.0 许可证。