MCPHubBETA
功能

统一控制平面，
管理你的 MCP 基础设施。

MCPHub 是一个开源、自托管的 MCP 网关与控制平面，用于统一管理 MCP Server 的连接、访问、凭据、路由与运行。

01 · 控制

控制 MCP 访问权限

通过 OAuth、OIDC、用户级密钥，以及限定到指定 Group 或 Server 的 Bearer Key 管理对 MCP 端点和服务器能力的访问。

  • GitHub、Google 和通用 OIDC 登录
  • 面向下游客户端和上游服务器的 OAuth
  • 用户级及范围受限的 Bearer Key
  • 附带认证上下文的 Tool 调用活动日志
OAuth 配置
REQUEST · AUTHORIZATION
POST /mcp/{group}
Authorization: Bearer mcphub-sk-***
X-User-Id:    u_8f3a
X-Scope:      tools.read,tools.write

→ 200 OK · 12 tools available
→ audit: u_8f3a → github.search_issues
→ audit: u_8f3a → linear.list_issues
GitHubGoogleOktaAuth0Generic OIDC
02 · 用户凭据

共享基础设施，用户独立凭据

只需定义一次 MCP Server，每个用户都可以安全绑定自己的上游凭据。

  • 用户级加密凭据
  • stdio 用户运行时隔离
  • 独立 HTTP Header / API Key
  • 共享 Server 配置但不共享 Secret
用户凭据指南
用户级加密凭据
stdio 用户运行时隔离
独立 HTTP Header / API Key
共享 Server 配置但不共享 Secret
03 · 路由

组织服务器与路由

将服务器按团队、项目或用途分组，通过稳定的 URL 提供聚合、限定范围、单服务器和智能路由，无需重新部署。

  • /mcp — 聚合（所有工具）
  • /mcp/{group} — 限定到指定分组
  • /mcp/{server} — 单服务器直通
  • /mcp/$smart — 语义工具发现
路由文档
/mcpaggregate247 tools
/mcp/{group}groupscoped
/mcp/{server}single1 server
/mcp/$smartsemantictop-k
04 · 智能路由

语义工具发现

当服务器超过 30 台、工具超过 200 个时，模型很难一次性消化全部上下文。智能路由会将每个工具描述写入向量索引，并按请求只返回最匹配的一组工具。

  • pgvector + OpenAI / Azure OpenAI embeddings
  • 支持 OpenAI 兼容接口
  • 按请求调整 top-k
  • 向量库不可用时回退到关键词搜索
  • 兼容所有 MCP 客户端
智能路由指南
“Find the last 5 issues mentioning database timeouts and create a tracking doc.”
SEMANTIC MATCH
github.search_issues0.94
linear.list_issues0.87
notion.create_page0.83
sentry.list_errors0.61
05 · 运行

集中运行与运维

监控每台 MCP 服务器的健康状态、延迟和工具用量。在一个地方启停服务、热重载配置、管理服务器认证与 OAuth 连接。

  • 每台服务器的实时健康检查
  • 热重载无需重启客户端
  • 记录 Tool 调用活动，包括用户、API Key、状态、耗时和来源 IP
运维文档
Servers · health overview
● all healthy
G
github
v2025.05.17
120ms● healthy
P
postgres
v2025.05.16
137ms● healthy
P
playwright
v2025.05.15
154ms● healthy
S
slack
v2025.05.14
171ms● healthy
B
brave-search
v2025.05.13
188ms● healthy
06 · 共享访问

Group 与用户级可见性

将 MCP Server 分享给指定用户，并通过 Group Endpoint 暴露不同的 Tool 集合。每个 Group 可以独立选择需要暴露的 Server、Tool、Prompt 和 Resource。

  • 私有、公开及指定用户共享的 Server 可见性
  • 用户级资源归属和访问控制
  • Group 可选择暴露的 Tool、Prompt 和 Resource
  • 用户级及范围受限的 Bearer Key
共享访问文档
platform-eng
14 users
githubpostgressentrylinear
data-team
8 users
postgressqlitesnowflake
support
22 users
slacknotionlinear
07 · 数据库模式

PostgreSQL 后端存储

当你需要为生产部署提供持久化、集中化的存储时，可以把内嵌 JSON 存储切换为 PostgreSQL。

  • 基于 PostgreSQL 的配置与运行时元数据
  • 持久保存用户、服务器、分组、OAuth 与活动数据
  • 兼容托管 PostgreSQL 服务
  • 适合作为生产部署的存储基础
数据库模式 
services:
  mcphub:
    image: samanhappy/mcphub
    environment:
      DATABASE_URL: postgres://...
      AUTH_SECRET:  ${AUTH_SECRET}
    depends_on: [postgres]

  postgres:
    image: postgres:16
    volumes: [pgdata:/var/lib/postgresql/data]
NeonSupabaseAWS RDSCrunchySelf-hosted

准备好通过一个网关运行 MCP 服务器了吗？

一条 Docker 命令，五分钟起步，初始配置为零。

用 Docker 部署查看文档