mirror of https://github.com/samanhappy/mcphub.git synced 2025-12-24 02:39:19 -05:00

Files

samanhappy 7887a3a5f9 docs: update README to reflect changes in HTTP endpoint support and deprecate SSE endpoint (#38 )

2025-04-28 14:49:40 +08:00

5.1 KiB

Raw Blame History

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

English Version | 中文版

MCPHub 是一个统一的 MCP（Model Context Protocol，模型上下文协议）服务器聚合平台，可以根据场景将多个服务器聚合到不同的 SSE 端点。它通过直观的界面和强大的协议处理能力，简化了您的 AI 工具集成流程。

🚀 功能亮点

开箱即用的 MCP 服务器支持：无缝集成 amap-maps、playwright、fetch、slack 等常见服务器。
集中式管理控制台：在一个简洁的 Web UI 中实时监控所有服务器的状态和性能指标。
灵活的协议兼容：完全支持 stdio 和 SSE 两种 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 部署

访问控制台

打开 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 端点：

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

其中 {group} 是您在控制面板中创建的分组 ID 或名称。这样做可以：

连接到按用例组织的特定 MCP 服务器子集
隔离不同的 AI 工具，使其只能访问相关服务器
为不同环境或团队实现更精细的访问控制
通过分组名称轻松识别和管理服务器
允许不同的 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
协议：Model Context Protocol SDK

👥 贡献指南

期待您的贡献！

新功能与优化
文档完善
Bug 报告与修复
翻译与建议

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

📄 许可证

本项目采用 Apache 2.0 许可证。

5.1 KiB Raw Blame History Unescape Escape