一、项目介绍

MCP 火了之后,很多人同时挂着十几个 MCP 服务器:本地一个、远程一个、团队共享一个,凭证散落、权限不清、哪个挂了也不知道。AI 客户端直接连裸服务器,既难治理,也难在多客户端间复用同一套能力。
MCPHub 是一个开源、可自托管的 MCP 网关与控制面,在 AI 客户端和 MCP 服务器之间立起统一的控制点:本地和远程服务器只接一次,通过稳定端点对外暴露,用认证、作用域凭证、按用户可见性来做访问控制,再配上集中日志、活动追踪与健康监控。Claude Code、Cursor、Cherry Studio、OpenWebUI 等都能直接连,把“一堆裸 MCP”变成“可运营的服务网格”。

二、项目基本信息

信息项详情
项目名称MCPHub
GitHub地址https://github.com/samanhappy/mcphub
项目描述Self-hosted MCP gateway and control plane for connecting, controlling, and operating MCP servers.
作者samanhappy
开源协议Apache-2.0
开源状态公开
LanguagesTypeScript
支持平台Windows / macOS / Linux
最后更新2026-10-29

三、核心优势

  • 连接一次,处处暴露:统一网关稳定端点对外服务
  • 智能路由:基于向量语义搜索的 AI 工具发现
  • 访问控制:认证、作用域凭证、按用户可见性
  • 可观测:集中日志、活动追踪、健康监控
  • 可自托管:Docker 一键起,数据自己掌握

四、适用场景

适合同时管理多个 MCP 服务器、且对权限与可观测性有要求的团队:希望把分散的 MCP 能力集中治理,并在多个 AI 客户端间安全复用。

五、安装教程

当前最新版本 v1.1.13。按下方命令安装(如遇网络问题可切换镜像源或代理):

# 方式一:npx 直接运行
npx @samanhappy/mcphub
# 方式二:Docker 自托管
 docker run -d -p 5100:5100 samanhappy/mcphub

常见报错:依赖缺失时先升级运行环境(Node、Python、Go 等)到项目要求版本;网络超时多为镜像或代理问题,可重试或换源。权限类报错请确认已登录对应平台账号。

六、使用示例

下面是一段可直接参考的真实示例:

# 启动后打开控制台
# 浏览器访问 http://localhost:5100
# 在控制台添加本地/远程 MCP 服务器,复制稳定端点
# 填入 Claude Code / Cursor 等客户端的 mcp 配置即可

七、常见问题

问:和直连 MCP 有什么区别?答:多一层治理与路由,便于权限、复用与监控。问:数据会出本地吗?答:可完全自托管,服务器与凭证都在你侧。

八、总结

MCPHub 用一个清晰的设计,把把第三方能力安全收拢到统一控制面这件反复劳动变成了可复用、可维护的能力。它不追求大而全,而是把核心痛点解决得足够扎实——这正是日常开发与团队落地时最需要的那种工具。如果你也在被同类问题困扰,不妨按上面的安装与使用步骤试一试,把它接进自己的工作流。