一、项目介绍

当团队里用 MCP 的 Agent 越来越多，直接让每个 Agent 各自连一堆 MCP 服务器，很快就会失控：凭证散落、权限不清、服务器上下线没人管、统一审计做不到。大公司尤其头疼——他们需要的是一套能治理、能鉴权、能审计的入口，而不是一堆散装连接。
mcp-gateway-registry 是一个企业级 MCP 网关与注册中心：它在 AI 开发工具和后端 MCP 服务器之间做了一层集中治理，提供安全的 OAuth 鉴权、动态工具发现、统一访问入口，并配套一个可检索的注册 UI。对想把 MCP 真正用进生产、还要满足合规与审计的团队，它是关键的中枢。

二、项目基本信息

信息项详情
项目名称mcp-gateway-registry
GitHub地址https://github.com/agentic-community/mcp-gateway-registry
项目描述Enterprise-ready MCP Gateway & Registry that centralizes AI development tools with secure OAuth authentication, dynamic tool discovery, and unified access for both autonomous AI agents and AI coding assistants. Transform scattered MCP server chaos into governed, auditable tool access with Keycloak/Entra integration.
作者agentic-community
开源协议Apache License 2.0
开源状态公开
LanguagesPython
支持平台Windows / macOS / Linux
最后更新2026-10-28

三、核心优势

  • 集中治理：统一入口管理所有 MCP 服务器
  • 安全鉴权：内置 OAuth、密钥与细粒度作用域
  • 动态发现：工具动态注册与发现，客户端免配置
  • 可自托管：提供预构建镜像，支持 EC2 / ECS / EKS
  • 配套 UI：注册中心带可视界面，便于查找与发布

四、适用场景

适合中大型团队把 MCP 接入生产环境，需要统一鉴权、审计与服务器治理的场景。已经用 Keycloak、MongoDB 等基础设施的公司接入尤其顺。

五、安装教程

当前最新版本 latest。按下方命令安装：

git clone https://github.com/agentic-community/mcp-gateway-registry.git
cd mcp-gateway-registry
cp .env.example .env   # 设置 KEYCLOAK_ADMIN_PASSWORD、SECRET_KEY 等
./build_and_run.sh --prebuilt   # 用预构建镜像启动（需 Docker）

常见报错：依赖缺失时先升级对应运行环境（Node、Python、.NET、Go、Java、Rust、Bun、JDK）；网络超时多为镜像或代理问题，可重试或换源；Docker 相关命令需已安装并启动 Docker 服务；涉及 API Key 的服务请提前在环境变量或配置文件中填好。

六、使用示例

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

# 启动后打开注册中心 UI：
# http://localhost
# 在 .env 里填好密钥后，Agent 侧通过网关地址统一访问工具，
# 例如把 mcpServers 指向网关而非直连各服务器；
# 运维可在 UI 里注册新服务器、分配作用域与审计调用记录。

七、常见问题

问：依赖很重吗？答：默认走预构建镜像，需 Docker；完整生产部署还用到 Keycloak 与 MongoDB。问：只能跑在 AWS 吗？答：提供 EC2 / ECS / EKS 的部署说明，也能在任意装了 Docker 的机器上跑。

八、总结

mcp-gateway-registry 用清晰的设计，把把 MCP 或代理能力平台化治理这件事从重复劳动变成了可复用、可维护的工程能力。它不追求大而全，而是把核心痛点解决得足够扎实，这正是日常开发与团队落地时最需要的那种工具。如果你也在被同类问题困扰，不妨按上面的安装与使用步骤试一试，把它接进自己的工作流。