← 返回目录

MCP Hub

社区

网关 / 代理

集中管理多个 MCP 服务器的中枢服务，提供统一端点与实时监控

这是聚合或代理其他 MCP Server 的网关，需要再接入具体的 Server 才有实际能力。

查看安装方法 ↓ 横向对比 GitHub 源仓库 ↗

分类: 开发工具第 74 / 438
Stars: ★ 521 热门
传输方式: stdio（本地进程） · SSE · Streamable HTTP
运行环境: Node.js 18+
凭据: 无需凭据
许可证: MIT
最近提交: 14 个月前 ⚠

63FMRS · C

MCP Hub 是一个聚焦于多 MCP 服务器集中编排与监控的工具，亮点是单一 /mcp 端点聚合所有能力、自动命名空间防冲突、实时 SSE 事件与 VS Code 配置兼容。它并不实现 Roots、Sampling、Completion 能力，也不托管任何具体的业务工具；使用前需注意 ${cmd:} 命令执行与密钥注入带来的安全面。

最强项 · 文档质量 16/20 最弱项 · 安全与权限 9/20

可靠性

10/20

安全与权限

9/20

维护活跃度

14/20

文档质量

16/20

安装易用性

14/20

查看各项评分依据

可靠性 10/20: 静态审查仅见 README，仓库根目录无缓存 manifest，未见 CI 工作流或提交的测试文件。功能面（统一 /mcp 端点、命名空间隔离、SSE 事件、自动重连、健康检查、错误分类）描述完备，但全部依赖文档自述，无法验证初始化握手与工具清单是否与真实行为一致。未披露具体版本兼容性测试与失败模式复现方式。按静态校准上限 12 分原则取 10：主路径看似可跑，但验证证据缺失，错误与依赖可控性只能部分判定。
安全与权限 9/20: 未见恶意代码或凭据外泄迹象。风险点在于设计：${cmd: ...} 占位符可在配置中执行任意本地命令（如 op/aws），并把输出注入环境变量与请求头；MCP_HUB_ENV 会把密钥注入所有被管服务器的环境；/api/* 为本地 REST 接口，README 未说明默认监听地址、是否限制 localhost、是否需认证，也未见针对命令执行与工具调用的确认机制。OAuth 2.0 + PKCE 属正向设计。无红线（无窃取凭据、无默认不可逆破坏操作），但最小权限、确认与数据流披露不完整，评 9。
维护活跃度 14/20: MIT 许可证明确，517 星、21 个 open issues，作者 ravitemer 及其配套项目（mcphub.nvim、mcp-registry）形成清晰归属与更新路径，README 中 Todo 有已完成项，说明仍在演进。但未提供带日期的发布记录、依赖更新策略或安全响应渠道，静态证据仅限 README。介于“活跃但治理/版本信息有缺口”一档，评 14。
文档质量 16/20: 文档质量较高：安装命令、CLI 选项、STDIO 与远程服务器配置字段、VS Code 兼容与变量替换、多条 REST 端点与响应示例、SSE 事件类型与负载、错误类与日志位置、架构时序图、注册表说明齐备。扣分项：未给出 MCP 协议版本与自身版本之外的兼容矩阵，未说明认证/鉴权要求与限流，成本与故障排查仅有零散提及，且大量内容属自述无法复核。评 16。
安装易用性 14/20: 路径清晰：npm i -g mcp-hub 后以 --port 与 --config 启动，并提供单端点客户端配置示例；Nix flake 与 Neovim 集成示例进一步降低门槛。但需自行编写/准备配置文件，dev 模式的 cwd 必须为绝对路径，VS Code ${input:} 依赖 MCP_HUB_ENV 手动设置，缺少端到端从零到可用连接的连贯教程与常见失败排查。静态校准下不超过 15，评 14。

静态评测 · 未实际运行收录于 2026-09-10

查看 FMRS 评分方法 →

选型与风险

能访问什么执行命令或代码访问网络

适合谁

需要同时编排多个 MCP 服务器的开发者
希望客户端只配置一个端点的用户
需要实时状态与能力变更通知的自动化工作流

不适合谁

只需要连接单个简单 MCP 服务器、不想引入中间层的用户
需要 Roots、Sampling 或 Completion 能力的客户端（当前不支持）
无法运行 Node.js 18+ 环境的使用者

所需权限

读取并解析指定的 JSON 配置文件
通过 ${cmd:} 占位符执行本机命令以获取配置值
注入 MCP_HUB_ENV 及服务器级 env 环境变量到受管子进程
以配置中的 command/args 在本机启动 stdio 子进程
向配置的远程 URL 发起网络请求并携带自定义认证 Header
在 XDG 状态目录写入日志与工作区缓存文件

风险与副作用

${cmd: command args} 会在配置解析时执行任意本机命令，配置被篡改时风险较高
启动本地 stdio 服务器等同于以当前用户权限运行任意命令
MCP_HUB_ENV 与服务器 env 中可能包含密钥，若配置文件或日志被他人读取可能泄露
远程服务器凭据（OAuth、Bearer Token）需妥善保管
--auto-shutdown 关闭不当可能导致服务意外退出

安装接入

准备工作

运行环境：Node.js 18+

MCP_HUB_ENV 可选密钥一个 JSON 字符串环境变量，向所有托管的 MCP 服务器注入共享键值（如 ${input:} 变量或令牌）；内容可能包含密钥，仅在需要共享配置时设置。

使用 npm 全局安装：npm install -g mcp-hub。
准备 JSON 配置文件（支持 JSON5、VS Code 的 servers/mcpServers 键以及 ${} 占位符语法）。
启动服务：mcp-hub --port 3000 --config path/to/config.json（可多次指定 --config，按顺序合并）。
将 MCP 客户端配置为连接单一端点，例如 Claude Desktop 的配置：{"mcpServers":{"Hub":{"url":"http://localhost:37373/mcp"}}}。

要求 Node.js >= 18.0.0。

claude_desktop_config.json

{
  "mcpServers": {
    "Hub": {
      "url": "http://localhost:37373/mcp"
    }
  }
}

以 Claude Desktop 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

{
  "servers": {
    "Hub": {
      "url": "http://localhost:37373/mcp"
    }
  }
}

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

claude mcp add --transport http Hub http://localhost:37373/mcp

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

在客户端中添加 http://localhost:37373/mcp 端点后，检查工具列表中是否出现带命名空间前缀（如 server__tool）的工具；也可运行 GET /api/health 确认状态为 ready。

常见排障

服务无法启动时检查 Node.js 版本是否 >= 18.0.0
客户端连接失败时确认端口与 /mcp 路径一致（默认示例为 37373）
配置未生效时确认 --config 路径正确，并注意多个配置文件按顺序后覆盖前
环境变量或命令未解析时检查 ${} 占位符写法与 `${cmd:}` 的输出
端口冲突可查看工作区缓存 $XDG_STATE_HOME/mcp-hub/workspaces.json，必要时清理失效条目
排查问题时查看日志 $XDG_STATE_HOME/mcp-hub/logs/mcp-hub.log

试试这样问

连接成功后，可以直接对 AI 助手这样说：

列出 Hub 中当前已连接的所有 MCP 服务器及其可用工具
通过 Hub 调用 filesystem 服务器的 search 工具
启动配置文件里的 myserver 服务器并查看其状态
刷新所有服务器的工具、资源和提示词能力列表

使用场景

通过一个端点把多个 MCP 服务器接入 Claude Desktop 等客户端

统一管理本地（stdio）和远程（streamable-http/SSE）MCP 服务器的启停与配置

用 REST API 或 SSE 事件实时监控服务器状态与能力变化

在 VS Code 与 MCP Hub 之间复用同一份 mcp.json 配置

在 Neovim 中通过 mcphub.nvim 调用 MCP 工具与资源

支持客户端

Claude Desktop

Cline

Neovim

依据项目文档列出，未经本站实测。

详细介绍

MCP Hub 是 MCP 服务器与客户端之间的中央协调器，提供两个关键接口：管理接口（/api/*）通过统一的 REST API 和 Web UI 管理多个 MCP 服务器；MCP 服务器接口（/mcp）让任意 MCP 客户端通过单一端点访问所有服务器的能力。它实现了 MCP 2025-03-26 规范，支持 stdio、streamable-http 与 SSE 传输，支持 OAuth 2.0（PKCE）与基于 Header 的令牌认证，并具备服务器生命周期管理、健康监控、自动重连、热重载、实时事件推送（SSE）以及 VS Code 配置兼容等能力。