← 返回目录

MetaMCP

社区

网关 / 代理

将多个 MCP 服务器聚合为统一端点的自托管网关。

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

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

分类: 开发工具第 121 / 438
Stars: ★ 2.7k 非常热门
传输方式: SSE · Streamable HTTP
运行环境: Docker · Node.js
凭据: 可选 API Key
许可证: MIT
最近提交: 4 个月前

60FMRS · C

来源显示 MetaMCP 是 MIT 许可的自托管 MCP 聚合与网关项目，支持工具、资源和提示，并提供命名空间、端点、认证、OIDC、限流、工具覆盖和中间件能力。当前来源未提供具体工具名称或已缓存的服务器清单；部分搜索、更多中间件和无头管理 API 仍列在路线图中。

最强项 · 文档质量 15/20 最弱项 · 可靠性 10/20

可靠性

10/20

安全与权限

12/20

维护活跃度

10/20

文档质量

15/20

安装易用性

13/20

查看各项评分依据

可靠性 10/20: README 描述了 MCP 初始化、工具聚合、请求转发、SSE 和 Streamable HTTP 等主要路径，成功流程总体可信；但未提供缓存的服务器清单、已执行证据、提交的测试或 CI 覆盖，且部分中间件功能标为即将推出，因此错误处理、边界行为和实际工具一致性无法验证，扣分。
安全与权限 12/20: 文档显示支持 API 密钥、Bearer 认证、OAuth/OIDC、PKCE、多租户、私有/公开范围和速率限制，并建议使用环境变量引用保存密钥；但作为可配置网关，它会启动 STDIO 命令并连接外部 MCP 服务，权限隔离、危险操作确认、数据流边界和密钥泄露防护未被充分证明，速率限制在集群中仅为进程内，故未给高分。
维护活跃度 10/20: 项目使用 MIT 许可证，README 提供仓库、贡献入口，并提到持续合并 PR；但作者明确说明近期维护延迟，且仅凭提示材料无法验证发布节奏、提交活跃度、依赖更新、漏洞响应流程或明确的维护承诺，因此按证据不足扣分。
文档质量 15/20: README 覆盖 Docker Compose、本地开发、客户端连接、认证方式、OIDC、速率限制、日志、代理配置、冷启动和已知限制，并提供多种配置示例；但未给出完整工具参数、成本、数据处理边界、危险副作用确认机制和可审查的测试证据，且部分能力标注为 coming soon，故扣分。
安装易用性 13/20: Docker Compose、环境文件、开发容器、本地开发步骤以及 Cursor、Claude Desktop 和代理配置均有说明，主流连接路径较清晰；但需要 Docker、Postgres、外部网络、可能的自定义依赖和反向代理配置，STDIO 客户端还需额外代理，流程并非低摩擦，且没有 CI/测试证据支持更高分。

静态评测 · 未实际运行收录于 2026-07-29

查看 FMRS 评分方法 →

选型与风险

能访问什么访问网络

适合谁

需要自托管 MCP 基础设施的开发者和组织。
需要集中管理多个 MCP 服务器、命名空间、端点和访问密钥的团队。
需要通过认证、限流和工具筛选控制 MCP 暴露面的部署。

不适合谁

只需要连接单个 MCP 服务器且不需要聚合或网关功能的用户。
无法运行 Docker 或提供所需运行环境的部署。
只支持 STDIO 且不允许使用本地代理的客户端场景。

所需权限

需要访问和管理已配置的上游 MCP 服务器。
使用 STDIO MCP 服务器时，可能需要启动其命令及相关依赖。
可能需要读取容器环境变量中的密钥和其他配置。
启用认证时，需要处理会话、API Key 或 OIDC 登录信息。
部署服务需要网络、Docker 和持久化 PostgreSQL 存储。

风险与副作用

错误配置可能将多个上游 MCP 服务器或工具暴露到同一公共端点。
环境变量和 API Key 处理不当可能导致凭据泄露。
公共端点可能受到未授权调用、过量请求或上游工具滥用。
限流计数器存储在内存中，集群中每台机器独立计数。
运行 STDIO 服务器及其依赖会扩大容器中的执行和网络访问范围。

安装接入

准备工作

运行环境：Docker · Node.js

API_ACCESS_TOKEN 可选密钥外部访问端点时使用的 MetaMCP API 密钥（格式 sk_mt_...），在 MetaMCP 管理界面中生成。

OIDC_CLIENT_SECRET 可选密钥 OIDC 登录的客户端密钥，从身份提供商获取，属于敏感凭据。

其他可选配置项（7 个）

APP_URL 可选应用访问地址，MetaMCP 会据此强制执行 CORS 策略。

LOG_LEVEL 可选控制日志镜像到控制台的级别，可选 all、info、errors-only、none，默认 errors-only。

OIDC_CLIENT_ID 可选 OIDC SSO 登录的客户端 ID，从你的身份提供商（如 Auth0、Keycloak）获取。

OIDC_DISCOVERY_URL 可选身份提供商的 OpenID 发现 URL，通常以 /.well-known/openid-configuration 结尾。

OIDC_PROVIDER_ID 可选可选的 OIDC 提供商标识，默认为 oidc。

OIDC_SCOPES 可选可选的 OAuth 请求范围，默认为 openid email profile。

OIDC_PKCE 可选可选，是否启用 PKCE（默认启用）。

克隆仓库，复制 example.env 为 .env，然后运行 docker compose up -d。默认推荐使用 Docker Compose。配置端点和命名空间后，将生成的 SSE 或 Streamable HTTP 地址填入客户端配置。仅支持 STDIO 的客户端需要使用本地代理，例如 mcp-proxy。

.cursor/mcp.json

{"mcpServers":{"MetaMCP":{"url":"http://localhost:12008/metamcp/<YOUR_ENDPOINT_NAME>/sse"}}}

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

.vscode/mcp.json

{
  "servers": {
    "MetaMCP": {
      "url": "http://localhost:12008/metamcp/<YOUR_ENDPOINT_NAME>/sse"
    }
  }
}

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

Terminal

claude mcp add --transport http MetaMCP 'http://localhost:12008/metamcp/<YOUR_ENDPOINT_NAME>/sse'

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

生成并校验客户端配置

验证是否装好

将 MCP 客户端连接到 http://localhost:12008/metamcp/<YOUR_ENDPOINT_NAME>/sse，确认客户端工具列表中出现已配置 MCP 服务器的聚合工具，或使用 MetaMCP 内置 Inspector 验证端点是否响应。

常见排障

确认客户端使用实际的端点名称以及正确的 SSE 或 Streamable HTTP 路径。
SSE 不支持通过 api_key 查询参数认证；优先使用 Authorization: Bearer <API_KEY>。
仅支持 STDIO 的客户端使用 mcp-proxy；README 指出 mcp-remote 不适用于 MetaMCP API Key 认证。
确认 APP_URL 与访问地址一致，因为 MetaMCP 会执行 CORS 限制。
检查 Docker、Docker Compose、PostgreSQL、上游服务器依赖和环境变量配置。
需要降低冷启动时，检查空闲会话设置并考虑在自定义 Dockerfile 中预装依赖。
使用反向代理时，检查 SSE 长连接相关的 Nginx 配置。

试试这样问

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

列出我的 MetaMCP 端点上所有可用的工具。
通过聚合端点调用 HackerNews 工具并总结热门内容。
显示当前哪些工具处于停用状态，方便我过滤掉它们。
检查我的 MetaMCP 命名空间暴露的工具，确认它们能正常加载。

使用场景

将多个 MCP 服务器组合为统一的 MCP 端点。

按命名空间选择服务器和工具，并覆盖工具名称、标题、描述和注释。

为 MCP 端点提供 API Key 或 MCP OAuth 认证。

通过中间件过滤工具并进行请求和响应处理。

使用带保存配置的 Inspector 调试 MCP 端点。

为 Open WebUI 等客户端提供 OpenAPI 端点。

支持客户端

Cursor

Claude Desktop部分支持

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

详细介绍

MetaMCP 是一个 MCP 代理、聚合器、编排器、中间件和网关。它可以将多个 MCP 服务器组合到命名空间中，按服务器或工具启用、禁用和覆盖工具元数据，并通过统一的 SSE、Streamable HTTP 或 OpenAPI 端点提供服务。MetaMCP 本身也是 MCP 服务器，可连接支持这些传输方式的 MCP 客户端。