Token导航 LogoToken导航TokenDH.com
MCP Gateway Registry logo
开发工具stdio官方级别未说明来源级核验

MCP Gateway Registry

MCP Server

MCP网关与注册中心是一个统一平台,用于集中访问MCP服务器和AI代理,提供统一的MCP服务器网关、服务器注册与发现、代理注册与A2A通信中心功能,适用于AI代理和编码助手治理、企业安全合规和动态工具发现等场景。

工具数

0

提示词数

0

GitHub Stars

0

资源数

0
AI开发工具PythonClaudeClaudeCursorClineVS Code

安装说明

本站只整理中文说明和来源信息,不托管安装包,也不代用户安装。

作者 / 组织

charles-future

提供方

charles-future

最后核验

2026/5/17 20:23

运行时

Python

快速接入

先看主来源和安装命令,再打开仓库或文档;下面只保留这个条目的关键接入事实。

命令预览

uv run pytest -m unit # Unit tests only

详细介绍

统一代理和MCP服务器注册表——人工智能开发工具的网关

](https://github.com/agentic-community/mcp-gateway-registry/stargazers) ](https://github.com/agentic-community/mcp-gateway-registry/network) ](https://github.com/agentic-community/mcp-gateway-registry/issues) ![License](https://github.com/agentic-community/mcp-gateway-registry/blob/main/LICENSE) ](https://github.com/agentic-community/mcp-gateway-registry/releases)

🚀 立即开始跑步 | macOS设置技能 | AWS工作室 | AWS部署 | 快速开始 | 文档 | 社区

______________________________________________________________________

什么是MCP网关和注册表?

MCP网关和注册表 是一个统一的平台,旨在使用 模型上下文协议(MCP)它具有三个核心功能:

  1. 统一MCP服务器网关 –多个MCP服务器的集中接入点
  2. MCP服务器注册表 –通过统一治理注册、发现和管理对MCP服务器的访问
  3. 代理注册和A2A通信中心 –代理注册、发现、治理以及通过 A2A(代理对代理)协议

该平台与外部注册表集成,如Anthropic的MCP注册表(以及更多即将推出的注册表),为工具访问、代理编排和代理到代理通信模式提供了一个单一的控制平面。

为什么统一? 该平台通过单个统一的控制平面提供对策划的MCP服务器和注册代理的安全、受控访问,而不是管理开发团队中数百个单独的MCP服务器配置、代理连接和单独的治理系统。

改变这种混乱:

❌ AI agents require separate connections to each MCP server
❌ Each developer configures VS Code, Cursor, Claude Code individually
❌ Developers must install and manage MCP servers locally
❌ No standard authentication flow for enterprise tools
❌ Scattered API keys and credentials across tools
❌ No visibility into what tools teams are using
❌ Security risks from unmanaged tool sprawl
❌ No dynamic tool discovery for autonomous agents
❌ No curated tool catalog for multi-tenant environments
❌ A2A provides agent cards but no way for agents to discover other agents
❌ Maintaining separate MCP server and agent registries is a non-starter for governance
❌ Impossible to maintain unified policies across server and agent access

采用这种有组织的方法:

✅ AI agents connect to one gateway, access multiple MCP servers
✅ Single configuration point for VS Code, Cursor, Claude Code
✅ Central IT manages cloud-hosted MCP infrastructure via streamable HTTP
✅ Developers use standard OAuth 2LO/3LO flows for enterprise MCP servers
✅ Centralized credential management with secure vault integration
✅ Complete visibility and audit trail for all tool usage
✅ Security features with governed tool access
✅ Dynamic tool discovery and invocation for autonomous workflows
✅ Registry provides discoverable, curated MCP servers for multi-tenant use
✅ Agents can discover and communicate with other agents through unified Agent Registry
✅ Single control plane for both MCP servers and agent governance
✅ Unified policies and audit trails for both server and agent access
┌─────────────────────────────────────┐     ┌──────────────────────────────────────────────────────┐
│          BEFORE: Chaos              │     │    AFTER: MCP Gateway & Registry                     │
├─────────────────────────────────────┤     ├──────────────────────────────────────────────────────┤
│                                     │     │                                                      │
│  Developer 1 ──┬──► MCP Server A    │     │  Developer 1 ──┐                  ┌─ MCP Server A    │
│                ├──► MCP Server B    │     │                │                  ├─ MCP Server B    │
│                └──► MCP Server C    │     │  Developer 2 ──┼──► MCP Gateway   │                  │
│                                     │     │                │    & Registry ───┼─ MCP Server C    │
│  Developer 2 ──┬──► MCP Server A    │ ──► │  AI Agent 1 ───┘         │        │                  │
│                ├──► MCP Server D    │     │                          │        ├─ AI Agent 1      │
│                └──► MCP Server E    │     │  AI Agent 2 ──────────────┤        ├─ AI Agent 2     │
│                                     │     │                          │        │                  │
│  AI Agent 1 ───┬──► MCP Server B    │     │  AI Agent 3 ──────────────┘        └─ AI Agent 3     │
│                ├──► MCP Server C    │     │                                                      │
│                └──► MCP Server F    │     │              Single Connection Point                 │
│                                     │     │                                                      │
│  ❌ Multiple connections per user  │     │         ✅ One gateway for all                      │
│  ❌ No centralized control         │     │         ✅ Unified server & agent access            │
│  ❌ Credential sprawl              │     │         ✅ Unified governance & audit trails        │
└─────────────────────────────────────┘     └──────────────────────────────────────────────────────┘
关于代理间通信的说明: AI代理通过统一的代理注册表发现其他AI代理并与它们通信 直接 (对等),无需通过MCP网关路由。注册表处理发现、身份验证和访问控制,而代理则保持直接连接,以实现高效、低延迟的通信。

统一代理和服务器注册表

该平台作为一个全面、统一的注册表,支持:

  • MCP服务器注册和发现 –注册、发现和管理对MCP服务器的访问
  • AI代理注册和发现 –注册代理并使他们能够发现其他代理
  • 代理到代理(A2A)通信 –使用A2A协议直接代理到代理的通信模式
  • 多协议支持 –支持各种代理通信协议和模式
  • 统一治理 –代理和服务器的单一策略和访问控制系统
  • 跨协议代理发现 –无论实施情况如何,代理都可以发现彼此
  • 综合外部登记处 –连接Anthropic的MCP注册表和其他外部来源
  • 代理卡和元数据 –代理功能、技能和身份验证方案的丰富元数据

主要区别: 与单独的点解决方案不同,这种统一的注册表消除了维护单独的MCP服务器和代理系统的需要,为代理编排、MCP服务器访问和代理到代理通信提供单个控制平面。

MCP服务器和代理注册表

观看MCP服务器、A2A代理和外部注册表如何协同工作以实现动态工具发现:

https://github.com/user-attachments/assets/f539f784-17f5-4658-99b3-d664bd5cecaa

______________________________________________________________________

MCP工具在行动

查看MCP工具演示

______________________________________________________________________

MCP注册表CLI

交互式终端界面,用于与人工智能模型聊天和用自然语言发现MCP工具。使用类似Claude Code的会话界面与注册表交谈,该界面具有实时令牌状态、成本跟踪和AI模型选择功能。

快速入门: registry --url https://mcpgateway.ddns.net | 完整指南

______________________________________________________________________

最新动态

  • 代理名称服务(ANS)集成 -通过GoDaddy为注册代理和MCP服务器添加基于PKI的信任验证 代理名称服务.代理所有者将其ANS代理ID链接到其注册表条目,注册表通过ANS API验证身份,在代理卡和语义搜索结果上显示可点击的信任徽章。后台调度器每6小时通过断路器保护重新验证所有链接的身份。支持使用管理员端点进行验证、过期和撤销状态跟踪,以进行手动同步、指标和健康检查。 设计和操作指南 | 演示视频
  • 联邦发现注册卡 -随着注册机构越来越需要相互发现和通信,我们实现了注册卡规范——一个可通过以下方式访问的标准化发现文档 /.well-known/registry-card这为任何注册表实例提供了基本的元数据,包括身份验证端点、功能和联系信息。增强的服务器、代理和技能卡具有更丰富的元数据,可实现更好的联盟工作流程。 注册表卡配置指南
  • 🔑 Okta身份提供者支持 -与Okta作为身份提供者的完整企业SSO集成。现有的统一IAM API现在支持Okta以及Keycapture和Microsoft Entra ID,提供了一个统一的界面来创建用户、组和M2M服务帐户,而不考虑您的IdP选择。功能包括对可扩展M2M身份验证的自定义授权服务器支持、对OAuth2客户端凭据令牌的数据库驱动组丰富,以及完整的Docker Compose和Terraform/ECS部署支持。使用相同的管理API和UI时,使用单个环境变量切换身份提供程序。 Okta设置指南
  • 🔐 企业安全态势文档 -全面的安全架构文档,涵盖所有部署平台(ECS、EKS、Docker Compose)的深度防御。详细介绍基础设施安全、使用KMS的静态/传输加密、使用自动轮换的秘密管理、遵循CIS基准的容器强化、使用自动扫描的应用程序安全(Semgrep、Bandit)、MCP服务器的供应链安全以及符合SOC 2/GDPR标准。 安全姿势指南
  • 📊 直接OTLP推送导出指标 -将指标直接推送到任何与OTLP兼容的可观察性平台(Datadog、New Relic、Honeycomb、Grafana Cloud),而不需要中间的OTEL收集器。通过环境变量进行配置(OTEL_OTLP_ENDPOINT, OTEL_EXPORTER_OTLP_HEADERS)用于与商业可观察性平台的即时集成。支持Docker Compose和Terraform/ECS部署,并通过AWS Secrets Manager进行安全的凭据处理。与现有的Prometheus/Grafana设置一起工作,用于混合监控。 度量体系结构指南-直接OTLP推送
  • AWS Workshop Studio:使用MCP网关和注册表保护AI代理生态系统 -实践研讨会,涵盖生产AI代理生态系统的部署、身份验证、治理和安全最佳实践。学习如何在AWS上部署MCP网关和注册表,配置企业身份验证,实施细粒度访问控制,以及保护AI代理通信。 开始工作坊
  • 💻 单命令macOS设置 -在MacBook上开始和尝试解决方案的最快方法。只需让Claude Code或您最喜欢的AI编码助手使用 macOS设置技能 它将自动克隆存储库,安装所有依赖项,配置服务(MongoDB、Keycloak、registry),注册示例服务器,并验证整个堆栈是否正在运行。非常适合单一开发人员环境和实践探索。只需一个命令,即可支持完全设置和完全拆卸。 *ECS/EKS部署技能即将到来。*
  • AI注册MCP服务器(航空注册工具) -使AI编码助手(Claude Code、Roo Code、Cursor等)能够直接从注册表中发现和查询MCP服务器、代理和技能。提供5个工具: list_services, list_agents, list_skills, intelligent_tool_finder (语义搜索),以及 healthcheck。在注册表启动时自动注册,无需手动设置。看 AI注册表工具文档 了解详情。
  • 治理和安全增强 -通过可搜索的过滤器(用户名、MCP服务器)和统计仪表板增强审计日志记录,显示顶级用户、操作、时间线图和每个用户的活动细分。系统正常运行时间和运行状况统计数据现在可以在标头中看到,其中包含部署信息、注册表统计数据和数据库状态。通过Bandit扫描进行全面的安全强化,解决了子流程安全(B603/B607)、SQL注入预防(B608)、硬编码凭据检测(B105)以及整个代码库中的其他漏洞模式。记录并解决所有安全发现,并为必要的例外情况提供适当的理由。
  • IAM设置UI -用于直接从web UI管理用户、组和M2M服务帐户的可视化界面。为服务器、工具、代理和UI功能创建和配置具有细粒度权限的访问控制组。使用组分配管理人类用户,并使用OAuth2客户端凭据为AI代理创建M2M服务帐户。功能包括可搜索的服务器/代理/工具选择器、用于范围配置的JSON导入/导出,以及在访问规则中支持MCP服务器和虚拟服务器。适用于Keycloak和Microsoft Entra ID身份提供程序。 IAM设置指南
  • 系统配置查看器 -通过设置UI查看和导出所有注册表配置参数。仅管理员面板显示11个配置组(部署、存储、身份验证、嵌入、运行状况、WebSocket、安全扫描、审计、联合、发现),并带有敏感值掩码。以ENV、JSON、TFVARS或YAML格式导出配置,以实现部署自动化。API端点在 /api/config/full/api/config/export. 配置指南
  • 虚拟MCP服务器支持 -将来自多个后端MCP服务器的工具、资源和提示聚合到一个统一的端点中。客户端连接到一个虚拟服务器,该服务器提供来自任何注册后端组合的经过策划、访问控制的功能视图。功能包括工具别名(解决命名冲突)、版本固定(锁定到特定后端版本)、基于每个工具作用域的访问控制、会话复用(一个客户端会话透明地映射到N个后端会话)和60秒缓存聚合 tools/list, resources/list,以及 prompts/list支持所有MCP JSON-RPC方法,包括 initialize, ping, tools/call, resources/read,以及 prompts/get. 设计文档 | 操作指南
  • 仅注册表部署模式 -将注册表作为独立的目录/发现服务运行,而不集成nginx网关。在 registry-only 在模式下,当服务器注册时,nginx配置不会更新,MCP代理请求返回503,其中包含使用直接连接的指令。前端适应显示 proxy_pass_url 而不是网关URL。结合 REGISTRY_MODE 设置(full, skills-only, mcp-servers-only, agents-only),您可以为特定用例配置注册表。例如,set REGISTRY_MODE=skills-only 运行一个专用的技能注册表,该注册表仅管理代理技能(SKILL.md文件),不需要MCP服务器或A2A代理,非常适合想要轻量级技能库的团队。UI自动调整以仅显示相关特征,并且用于禁用特征的API端点返回503。无效组合,如 with-gateway + skills-only 会自动纠正并发出警告。 注册表部署模式指南
  • 📋 合规性审核日志记录 -全面的审计日志记录,用于安全监控和合规性。捕获所有注册表API和MCP网关访问事件以及用户标识、操作详细信息和时间。功能包括自动凭证屏蔽(令牌、Cookie、密码从不记录)、基于TTL的日志保留(默认7天,可配置)、具有过滤和导出功能的仅限管理员的审计查看器UI(JSONL/CSV)以及非阻塞异步设计。支持SOC 2和GDPR要求,包括谁/什么/何时/何地/结果跟踪。 审核日志记录指南
  • 🌐 对等注册表联合会 -连接多个MCP网关注册表实例,以实现双向服务器和代理同步。中央IT团队可以聚合跨业务线注册表的可见性,或者LOB可以从中央中心继承共享工具。功能包括可配置的同步模式(全部、白名单、标签过滤器)、定时和按需同步、用于IdP无关部署的静态令牌身份验证、Fernet加密凭证存储、基于生成的孤立检测以及防止冲突的路径命名空间。同步的项目是只读的,并显示其源注册表。VS Code风格的设置UI提供对等管理、同步触发和状态监视。 架构设计 | 操作指南
  • 🔑 注册表API的静态令牌验证 -访问注册表API终结点(/api/*, /v0.1/*)使用静态API密钥而不是基于IdP的JWT验证。专为受信任的网络环境、CI/CD管道和CLI工具而设计,在这些环境中配置完整身份提供程序可能不切实际。MCP网关端点仍然需要完全的IdP身份验证。包括启动验证,如果未配置令牌,则禁用该功能。 静态令牌认证指南
  • 👥 具有协调API的多供应商IAM -Keycloak、Microsoft Entra ID和Okta的完整身份和访问管理支持。注册API为用户和组管理提供了统一的体验,无论您使用哪个IdP。人类用户可以通过UI登录,并为CLI工具和AI编码助手生成自签名的JWT令牌(具有与会话相同的权限)。服务帐户(M2M)通过OAuth2客户端凭据流启用AI代理身份。通过作用域的细粒度访问控制精确定义了每个用户可以访问的MCP服务器、方法、工具和代理。 身份验证设计 | IdP提供商架构 | 范围管理 | Entra ID设置 | OCT设置
  • 🏷️ 服务器和代理的自定义元数据 -为MCP服务器和代理添加丰富的自定义元数据,以进行组织、合规性和集成跟踪。元数据可以通过语义搜索进行完全搜索,支持“团队:数据平台”、“符合PCI-DSS”或“所有者:alice@example.com“。用例包括团队所有权、合规性跟踪(PCI-DSS、HIPAA)、成本中心分配、部署区域、JIRA票证和自定义标签。与现有注册向后兼容。 元数据使用指南
  • 🔎 增强型混合搜索 -改进的语义搜索将向量相似性与服务器、工具和代理的标记化关键字匹配相结合。明确的名字引用现在可以提高相关性得分,确保首先出现精确的匹配。 混合搜索架构
  • 🛡️ UI中的安全扫描结果 -安全扫描结果现在直接显示在服务器和代理卡上,带有颜色编码的屏蔽图标(灰色/绿色/红色)。单击屏蔽图标查看详细的扫描结果,并从UI触发重新扫描。 安全扫描程序文档
  • 📊 DocumentDB和MongoDB CE存储后端 -具有MongoDB兼容后端的分布式存储。DocumentDB为生产部署中低于100ms的语义查询提供本机HNSW矢量搜索,而MongoDB Community Edition 8.2则支持使用副本集进行功能齐全的本地开发。两个后端都使用相同的存储库抽象层,具有自动收集管理、优化索引和MongoDB CE的应用程序级向量搜索功能。使用单个环境变量在MongoDB CE(本地测试)和DocumentDB(生产)之间切换。注意:基于文件的存储已被弃用,并将在未来的版本中删除。建议使用MongoDB CE进行本地开发。 配置指南 | 存储体系结构
  • 🔒 A2A代理安全扫描 -A2A代理使用集成安全扫描 思科AI防御A2A扫描仪在代理注册过程中,通过YARA模式匹配、A2A规范验证和启发式威胁检测进行自动安全扫描。功能包括自动标记不安全的代理、可配置的阻止策略,以及使用API端点查看结果和触发重新扫描的详细扫描报告。
  • 🔧 注册表管理API -用于管理服务器、组和用户的新编程API。Python客户端(api/registry_client.py)具有类型安全接口、RESTful HTTP端点(/api/management/*),以及全面的错误处理。用现代API方法替换shell脚本,同时保持向后兼容性。 API 文档 | 服务管理指南
  • ⭐ 服务器和代理评级系统 -使用交互式五星级评级小部件对代理商进行评级和评论。用户可以通过UI或CLI提交评级,查看包含单个评级详细信息的汇总评级,并更新其现有评级。功能包括旋转缓冲区(每个代理最多100个评级)、每个用户一个评级、浮点平均值计算和完整的OpenAPI文档。支持社区驱动的代理质量评估和发现。
  • 🧠 灵活的嵌入支持 -从语义搜索的三个嵌入提供程序选项中进行选择:本地句子转换器、OpenAI或任何支持LiteLLM的提供程序,包括Amazon Bedrock Titan、Cohere和100多个其他模型。通过简单的配置更改切换提供程序。 嵌入指南
  • ☁️ AWS ECS部署 -采用多AZ架构的Amazon ECS Fargate上的部署配置、采用HTTPS的应用程序负载均衡器、自动扩展、CloudWatch监控和NAT网关冗余。部署整个堆栈的完整Terraform配置。 ECS部署指南
  • 📦 灵活的部署模式 -三种部署选项可满足您的要求:(1)仅CloudFront用于快速设置,无需自定义域;(2)带Route53/ACM的自定义域用于品牌URL;或(3)CloudFront+自定义域用于具有CDN优势的生产环境。 部署模式指南
  • 🔗 联合注册表 -MCP网关注册表现在支持来自其他注册表的服务器和代理的联合。 联盟指南
  • 🔗 代理到代理(A2A)协议支持 -代理现在可以通过安全、集中的注册表注册、发现和与其他代理通信。通过基于Keycloak的访问控制和细粒度权限启用自主代理生态系统。 A2A指南
  • 🏢 Microsoft Entra ID集成 -具有Microsoft Entra ID(Azure AD)身份验证的企业SSO。基于组的访问控制、条件访问策略以及与现有Microsoft 365环境的无缝集成。 Entra ID设置指南
  • 🤖 MCP注册表的代理CLI -使用类似Claude Code的界面用自然语言与注册表对话。通过对话发现工具、提问和执行MCP命令。 了解更多
  • 🔒 MCP服务器安全扫描 -集成漏洞扫描功能 思科AI防御MCP扫描仪。服务器注册期间自动进行安全扫描,定期进行注册表范围的扫描,并提供详细的降价报告,以及自动禁用存在安全问题的服务器。
  • 📥 从Anthropic MCP注册表导入服务器 -只需一个命令,即可从Anthropic的注册表中导入精心策划的MCP服务器。 进口指南
  • 🔌 Anthropic MCP注册表REST API兼容性 -与Anthropic的MCP注册表REST API规范完全兼容。 API 文档
  • 🔎 服务器、工具和代理的统一语义搜索 -使用以下方式在每个MCP服务器、其工具和注册的A2A代理上进行自然语言搜索 POST /api/search/semantic。从仪表板UI(会话cookie身份验证)或使用JWT Bearer令牌以编程方式工作,在单个响应中返回每个实体类型的相关性得分匹配。
  • 🔐 Keycloak集成 -具有AI代理审计跟踪和基于组的授权的企业身份验证。 了解更多
  • ⚡ 亚马逊基岩代理核心集成 -AgentCore网关支持双重身份验证。 集成指南

______________________________________________________________________

A2A代理-示例实现

该注册表包括两个示例A2A代理,展示了人类开发人员和自主AI代理如何通过统一的代理注册表发现、注册和使用代理。代理可以通过语义搜索以编程方式发现其他代理,并通过A2A协议使用它们,从而实现动态代理组合和自主代理编排。

代理示例

代理路径技能
旅行助理代理/travel-assistant-agent航班搜索、价格检查、推荐、旅行计划
航班预订代理/flight-booking-agent可用性检查、航班预订、付款、预订管理

代理发现

在注册表UI中查看: 打开注册表并导航到 A2A代理 选项卡,用于浏览已注册的代理及其完整的元数据、功能和技能。

通过CLI搜索: 开发人员可以通过自然语言描述搜索代理:

# Search for agents that can help book a trip
cli/agent_mgmt.sh search "need an agent to book a trip"

输出示例:

Found 4 agent(s) matching 'need an agent to book a trip':
--------------------------------------------------------------------------------------------------------------
Agent Name                               | Path                      | Score
--------------------------------------------------------------------------------------------------------------
Travel Assistant Agent                   | /travel-assistant-agent   |  0.8610
Flight Booking Agent                     | /flight-booking-agent     |  1.2134
--------------------------------------------------------------------------------------------------------------

代理到代理发现API

注册表提供 语义搜索API 代理可以将其用作在运行时发现其他A2A代理的工具。此API支持动态代理组合,其中代理基于功能而不是硬编码引用来查找合作者。

发现API终结点:

POST /api/agents/discover/semantic?query=&max_results=5
Authorization: Bearer 

答复包括:

  • 代理名称、描述和端点URL
  • 具有技能和能力的代理卡元数据
  • 排名匹配的相关性得分
  • 信任级别和可见性设置

代理商如何使用它:

  1. 代理使用自然语言查询调用注册表的语义搜索API(例如,“可以预订航班的代理”)
  2. 注册表返回匹配的代理及其端点URL和完整的代理卡元数据
  3. 代理使用代理卡了解功能,并通过A2A协议调用发现的代理

示例-旅行助理发现并调用航班预订代理:

User: "I need to book a flight from NYC to LA"

Travel Assistant:
  1. Calls registry API: POST /api/agents/discover/semantic?query="book flights"
  2. Registry returns Flight Booking Agent with endpoint URL and agent card
  3. Uses agent card to understand capabilities, then sends A2A message to Flight Booking Agent
  4. Returns booking confirmation to user

这种模式使代理能够通过发现无法直接处理的任务的专用代理来动态扩展其功能。

代理卡: 在以下位置查看代理卡元数据 代理/a2a/测试/ 查看完整的代理定义,包括技能、协议和功能。

有关完整的代理部署和测试文档,请参阅 agents/a2a/README.md.

______________________________________________________________________

核心用例

人工智能代理和编码助理治理

通过AI编码助手(VS Code、Cursor、Claude Code)为自主AI代理和人类开发人员提供对批准工具的安全访问,同时保持IT监督和合规性。

企业安全与合规

集中身份验证、细粒度权限和全面的审计跟踪,用于跨人类和人工智能代理访问模式的SOX/GDPR合规途径。

动态工具发现

人工智能代理可以使用智能语义搜索自主发现和执行超出其初始能力的专用工具,而开发人员则通过他们的编码助手获得指导工具发现。

统一接入网关

单一网关支持自主AI代理(机器对机器)和AI编码助手(人工引导),具有一致的身份验证和工具访问模式。

______________________________________________________________________

建筑

MCP网关和注册表为自主AI代理和AI编码助理提供了一个统一的平台,通过具有全面身份验证和治理的集中式网关访问企业策划的工具。

flowchart TB
    subgraph Human_Users["Human Users"]
        User1["Human User 1"]
        User2["Human User 2"]
        UserN["Human User N"]
    end

    subgraph AI_Agents["AI Agents"]
        Agent1["AI Agent 1"]
        Agent2["AI Agent 2"]
        Agent3["AI Agent 3"]
        AgentN["AI Agent N"]
    end

    subgraph EC2_Gateway["MCP Gateway & Registry (Amazon EC2 Instance)"]
        subgraph NGINX["NGINX Reverse Proxy"]
            RP["Reverse Proxy Router"]
        end
        
        subgraph AuthRegistry["Authentication & Registry Services"]
            AuthServer["Auth Server
(Dual Auth)"]
            Registry["Registry
Web UI"]
            RegistryMCP["Registry
MCP Server"]
        end
        
        subgraph LocalMCPServers["Local MCP Servers"]
            MCP_Local1["MCP Server 1"]
            MCP_Local2["MCP Server 2"]
        end
    end
    
    %% Identity Provider
    IdP[Identity Provider
Keycloak/Cognito]
    
    subgraph EKS_Cluster["Amazon EKS/EC2 Cluster"]
        MCP_EKS1["MCP Server 3"]
        MCP_EKS2["MCP Server 4"]
    end
    
    subgraph APIGW_Lambda["Amazon API Gateway + AWS Lambda"]
        API_GW["Amazon API Gateway"]
        Lambda1["AWS Lambda Function 1"]
        Lambda2["AWS Lambda Function 2"]
    end
    
    subgraph External_Systems["External Data Sources & APIs"]
        DB1[(Database 1)]
        DB2[(Database 2)]
        API1["External API 1"]
        API2["External API 2"]
        API3["External API 3"]
    end
    
    %% Connections from Human Users
    User1 -->|Web Browser
Authentication| IdP
    User2 -->|Web Browser
Authentication| IdP
    UserN -->|Web Browser
Authentication| IdP
    User1 -->|Web Browser
HTTPS| Registry
    User2 -->|Web Browser
HTTPS| Registry
    UserN -->|Web Browser
HTTPS| Registry
    
    %% Connections from Agents to Gateway
    Agent1 -->|MCP Protocol
SSE with Auth| RP
    Agent2 -->|MCP Protocol
SSE with Auth| RP
    Agent3 -->|MCP Protocol
Streamable HTTP with Auth| RP
    AgentN -->|MCP Protocol
Streamable HTTP with Auth| RP
    
    %% Auth flow connections
    RP -->|Auth validation| AuthServer
    AuthServer -.->|Validate credentials| IdP
    Registry -.->|User authentication| IdP
    RP -->|Tool discovery| RegistryMCP
    RP -->|Web UI access| Registry
    
    %% Connections from Gateway to MCP Servers
    RP -->|SSE| MCP_Local1
    RP -->|SSE| MCP_Local2
    RP -->|SSE| MCP_EKS1
    RP -->|SSE| MCP_EKS2
    RP -->|Streamable HTTP| API_GW
    
    %% Connections within API GW + Lambda
    API_GW --> Lambda1
    API_GW --> Lambda2
    
    %% Connections to External Systems
    MCP_Local1 -->|Tool Connection| DB1
    MCP_Local2 -->|Tool Connection| DB2
    MCP_EKS1 -->|Tool Connection| API1
    MCP_EKS2 -->|Tool Connection| API2
    Lambda1 -->|Tool Connection| API3

    %% Style definitions
    classDef user fill:#fff9c4,stroke:#f57f17,stroke-width:2px
    classDef agent fill:#e1f5fe,stroke:#29b6f6,stroke-width:2px
    classDef gateway fill:#e8f5e9,stroke:#66bb6a,stroke-width:2px
    classDef nginx fill:#f3e5f5,stroke:#ab47bc,stroke-width:2px
    classDef mcpServer fill:#fff3e0,stroke:#ffa726,stroke-width:2px
    classDef eks fill:#ede7f6,stroke:#7e57c2,stroke-width:2px
    classDef apiGw fill:#fce4ec,stroke:#ec407a,stroke-width:2px
    classDef lambda fill:#ffebee,stroke:#ef5350,stroke-width:2px
    classDef dataSource fill:#e3f2fd,stroke:#2196f3,stroke-width:2px
    
    %% Apply styles
    class User1,User2,UserN user
    class Agent1,Agent2,Agent3,AgentN agent
    class EC2_Gateway,NGINX gateway
    class RP nginx
    class AuthServer,Registry,RegistryMCP gateway
    class IdP apiGw
    class MCP_Local1,MCP_Local2 mcpServer
    class EKS_Cluster,MCP_EKS1,MCP_EKS2 eks
    class API_GW apiGw
    class Lambda1,Lambda2 lambda
    class DB1,DB2,API1,API2,API3 dataSource

主要架构优势:

  • 统一网关:通过编码助手为人工智能代理和人类开发人员提供单点访问
  • 双重认证:支持人类用户身份验证和机器对机器代理身份验证
  • 可扩展的基础设施:具有水平扩展功能的Nginx反向代理
  • 多个传输:SSE和Streamable HTTP支持不同的客户端需求

______________________________________________________________________

关键优势

安全特性

  • OAuth 2.0/3.0符合IdP集成
  • 工具和方法级别的细粒度访问控制
  • 零信任网络架构
  • 完整的审计跟踪和全面的合规分析

AI代理和开发人员经验

  • 单一配置适用于自主AI代理和AI编码助手(VS Code、Cursor、Claude Code、Cline)
  • 为代理和人类提供自然语言查询的动态工具发现
  • 新团队成员和AI代理部署的即时入职
  • 人工智能代理和人类开发人员的统一治理

部署功能

  • 容器原生(Docker/Kubernetes)
  • 实时健康监测和警报
  • 双重身份验证,支持人和机器身份验证

______________________________________________________________________

快速开始

设置MCP网关和注册表有4个选项:

  • 选项A:AI辅助macOS设置 --在macOS上入门的最快方式。让你的AI编码助手使用 macOS设置技能 用于全自动的一个命令设置。非常适合实验。
  • 选项B:预构建图像 --使用预构建的Docker或Podman容器快速设置。推荐给大多数用户。
  • 选项C:Podman(无根) --适用于macOS和无根Linux环境的详细Podman特定说明。
  • 选项D:从源代码构建 --用于定制或开发的完整源代码构建。

选项A:AI辅助macOS设置(最快)

在macOS上入门的最简单方法。 只需询问Claude Code或您的AI编码助理:

“使用macOS设置技能安装和配置MCP网关和注册表”

macOS设置技能 将自动:

  • ✅ 克隆存储库并安装所有依赖项(Homebrew、Python、UV、Docker、Node.js)
  • ✅ 使用副本集配置并启动MongoDB
  • ✅ 使用管理员用户设置并初始化Keycloak
  • ✅ 启动注册表和身份验证服务器
  • ✅ 注册Cloudflare MCP文档服务器
  • ✅ 验证整个堆栈是否正常运行

非常适合: 单一开发人员实验、快速演示、实践探索

您需要什么: 配备AI编码助手的macOS(Claude Code、Cursor等)

清理: 完成后,请您的AI助手“拆除MCP网关设置”以完成删除。

*注意:ECS/EKS部署技能即将用于生产部署。*

______________________________________________________________________

选项B:预构建图像(即时设置)

在几分钟内使用预构建的Docker容器运行。这是大多数用户的推荐方法。

# Clone and configure
git clone https://github.com/agentic-community/mcp-gateway-registry.git
cd mcp-gateway-registry
cp .env.example .env

# Edit .env with your passwords (KEYCLOAK_ADMIN_PASSWORD, etc.)
nano .env

# Deploy with pre-built images
export DOCKERHUB_ORG=mcpgateway
./build_and_run.sh --prebuilt

# Access the Registry UI
open http://localhost:7860  # macOS
# xdg-open http://localhost:7860  # Linux

完整的快速入门指南 -完整的分步说明,包括:

  • 先决条件安装(Docker、Python、UV)
  • 环境配置
  • MongoDB和Keycloak初始化
  • 用户和服务帐户设置
  • 服务器和代理注册
  • 测试网关功能

优点: 无需构建时间|无需Node.js |无需前端编译|经过一致测试的图像

______________________________________________________________________

选项C:Podman(无根容器部署)

非常适合macOS和无根Linux环境

Podman提供无根容器执行,不需要特权端口,非常适合:

  • macOS 使用Podman Desktop的用户
  • Linux 用户更喜欢无根容器
  • 发展 Docker守护进程不可用的环境

快速Podman设置(macOS非苹果Silicon):

# Install Podman Desktop
brew install podman-desktop
# OR download from: https://podman-desktop.io/

在Podman Desktop中,转到“首选项”>“Podman机器”,创建一台至少有4个CPU和8GB RAM的新机器。或者,查看更多详细信息 Podman安装指南 有关在CLI上设置此功能的说明。

# Initialize Podman machine
podman machine init
podman machine start

# Verify installation
podman --version
podman compose version

# Configure environment
cp .env.example .env
# Edit .env with your credentials

使用Podman进行部署 请参阅我们的完整Podman设置说明(下载、安装和初始化第一个Podman容器,以及故障排除) 安装指南.

使用Podman构建:

# Auto-detect (will use Podman if Docker not available)
./build_and_run.sh --prebuilt

# Explicit Podman mode (only non-Apple Silicon)
./build_and_run.sh --prebuilt --podman

# Access registry at non-privileged ports
# On macOS:
open http://localhost:8080
# On Linux: xdg-open http://localhost:8080
注: 苹果硅(M1/M2/M3)? 不使用 --prebuilt 波德曼在ARM64上。这将导致“代理已在运行”错误。看 波德曼谈苹果硅指南.
# To run on Apple Silicon Macs:
./build_and_run.sh --podman

与Docker的主要区别:

  • 无需root或sudo
  • 在没有特权端口访问的macOS上工作
  • HTTP端口: 8080 (而不是 80)
  • HTTPS端口: 8443 (而不是 443)
  • 所有其他服务端口不变

有关Podman设置的详细说明,请参阅 安装指南macOS安装指南.

选项D:从源代码构建

MCP网关新手? 从我们的开始 完整安装指南 有关AWS EC2从头开始的详细分步说明。

在macOS上运行? 查看我们的 macOS安装指南 用于平台特定的说明和优化。

测试和集成选项

测试套件: 该项目包括使用pytest进行全面的自动化测试:

# Run all tests
make test

# Run only unit tests (fast)
make test-unit

# Run with coverage report
make test-coverage

# Run specific test categories
uv run pytest -m unit           # Unit tests only
uv run pytest -m integration    # Integration tests
uv run pytest -m "not slow"     # Skip slow tests

测试结构:

  • 单元测试 (tests/unit/)-快速、隔离的组件测试
  • 集成测试 (tests/integration/)-组件交互测试
  • E2E测试 (tests/integration/test_e2e_workflows.py)-完成工作流程测试

Python代理:

  • agents/agent.py -具有高级AI功能的全功能Python代理

测试文件:

预提交钩子:

# Install pre-commit hooks
pip install pre-commit
pre-commit install

# Run hooks manually
pre-commit run --all-files

下一步: 完整安装指南 | 身份验证设置 | AI助手集成

______________________________________________________________________

企业功能

AI代理和编码助理集成

通过集中治理改变自主AI代理和开发团队访问企业工具的方式:

Enterprise-curated MCP servers accessible through unified gateway

AI assistants executing approved enterprise tools with governance

可观测性

通过具有双路径存储的Grafana仪表板进行全面的实时指标和监控:SQLite用于详细的历史分析,OpenTetry(OTEL)导出用于与Prometheus、CloudWatch、Datadog和其他监控平台集成。跟踪身份验证事件、工具执行、发现查询和系统性能指标。 了解更多

Real-time metrics and observability dashboard tracking server health, tool usage, and authentication events

Anthropic MCP注册表集成

与Anthropic的官方MCP注册表无缝集成,通过您的网关导入和访问精心策划的MCP服务器:

  • 导入服务器:使用单个命令从Anthropic的注册表中选择并导入所需的服务器
  • 统一访问:通过网关使用集中身份验证和治理访问导入的服务器
  • API兼容性:完全支持Anthropic的注册表REST API规范-将Anthroptic API客户端指向此注册表以发现可用的服务器

Import and access curated MCP servers from Anthropic's official registry

进口指南 | 注册API文档

联邦-外部注册表集成

统一多注册表访问:

  • 人类MCP注册表 -导入精心策划的紫色MCP服务器 ANTHROPIC 视觉标签
  • 工作日ASOR -用橙色从Agent记录系统导入AI代理 ASOR 视觉标签
  • 自动同步 -计划与外部注册表同步
  • 视觉识别 -清晰的视觉标签在UI中区分联盟源
  • 集中管理 -所有联邦服务器和代理的单一控制平面

快速设置:

# Configure federation sources
echo 'ASOR_ACCESS_TOKEN=your_token' >> .env

# Update federation.json with your sources
# Restart services
./build_and_run.sh

📖 完整的联盟指南 -环境设置、身份验证、配置和故障排除

安全扫描

集成漏洞检测:

  • 自动安全扫描 -使用以下工具对MCP服务器进行集成漏洞扫描 思科AI防御MCP扫描仪,在注册过程中自动扫描,并支持定期的注册表范围扫描
  • 详细的安全报告 -包含漏洞详细信息、严重性评估和补救建议的全面降价报告
  • 自动保护 -存在安全问题的服务器会自动禁用,并处于安全挂起状态,以保护您的基础架构
  • 合规就绪 -针对企业合规要求的安全审计跟踪和漏洞跟踪

身份验证和授权

多种身份模式:

  • 机器对机器(M2M) -适用于自主AI代理和自动化系统
  • 三条腿OAuth(3LO) -用于外部服务集成(Atlassian、谷歌、GitHub)
  • 基于会话 -适用于使用AI编码助手和web界面的人类开发人员

支持的身份提供程序: Keycloak、Amazon Cognito和任何兼容OAuth 2.0的提供商。 了解更多

细粒度权限: 工具级、方法级、基于团队和临时访问控制。 了解更多

部署选项

云平台: 亚马逊EC2、亚马逊EKS

______________________________________________________________________

部署

AWS弹性容器服务(ECS)

部署配置 在具有全面企业功能的Amazon ECS Fargate上:

  • 多AZ架构 -跨多个可用区的冗余
  • 应用负载均衡器 -HTTPS/SSL终止,通过ACM自动管理证书
  • 自动缩放 -基于CPU和内存利用率的动态扩展
  • CloudWatch集成 -全面的监控、记录和警报
  • NAT网关HA -用于安全出站连接的冗余NAT网关配置
  • Keycloak集成 -使用RDS Aurora PostgreSQL后端进行企业身份验证
  • EFS共享存储 -模型、日志和配置的持久存储
  • 服务发现 -用于服务到服务通信的AWS Cloud Map

完整的ECS部署指南 -使用Terraform部署整个堆栈的分步说明。

亚马逊EKS(Kubernetes)

即将推出 -在Amazon EKS上部署Kubernetes,并使用Helm charts进行大规模容器编排。

______________________________________________________________________

文档

入门企业设置开发人员和运营
完整安装指南
在AWS EC2上从头开始一步一步身份验证指南
OAuth和身份提供者集成AI编码助手设置
VS代码、游标、Claude代码集成
安装指南
EC2和EKS的完整设置说明AWS ECS部署
AWS ECS Fargate部署指南API 参考
程序化注册表管理
Keycloak集成
具有代理审计跟踪的企业身份令牌刷新服务
自动令牌刷新和生命周期管理MCP注册表CLI
用于注册表管理的命令行客户端
配置参考
环境变量和设置亚马逊Cognito设置
分步IdP配置观察性指南
度量、监控和OpenTetry设置
人类学登记导入
从Anthropic MCP注册表导入服务器联盟指南
外部注册集成(Anthropic、ASOR)
P2P联盟指南
对等注册表联盟
服务管理
服务器生命周期和操作人类注册表API
REST API兼容性
细粒度访问控制
权限管理和安全
动态工具发现
自主代理能力
部署指导
完成部署环境的设置
故障排除指南
常见问题和解决方案

______________________________________________________________________

社区

参与

加入讨论

  • -功能请求和一般讨论
  • -Bug报告和功能请求

贡献

明星历史

![Star History Chart](https://star-history.com/#agentic-community/mcp-gateway-registry&Date)

路线图

我们的开发路线图被组织成每周里程碑,具有明确的可交付成果和进度跟踪:

里程碑截止日期进度状态关键问题
停车场0% (0/11)🗂️ 积压11个待优先处理的未决问题

状态图例: 🚧 进行中•📅 计划中•🗂️ 积压•✅ 完成

______________________________________________________________________

主要功能

以下主要功能跨越了多个里程碑,代表了重大的架构改进:

通过凭证管理集成自动发现和注册Bedrock AgentCore网关。

在Keycloak、Entra ID、Auth0、GitHub和Google OAuth2旁边添加Okta作为身份提供者选项。

使用原生IDE支持MCP OAuth 2.1授权来实现RFC 9728受保护资源元数据。

将“MCP网关注册表”重命名为“AI网关和注册表”,以反映对MCP以外的代理和工具的扩展支持。

全面的遥测基础设施,包括服务器端收集器、客户端仪器和轻量级匿名采用跟踪。

使用Lua脚本的动态工具聚合和智能路由。允许将来自多个后端服务器的工具逻辑分组到单个虚拟端点中。

通过精心策划的注册表模式实现代理到代理的发现和工具调用。

具有双向同步、对等管理、链预防、孤立检测和跨注册表安全扫描传播的联合注册表。

通过统一的界面简化了MCP服务器和A2A代理的注册体验。

全面的限速架构,具有详细的工具使用控制实施指南。

______________________________________________________________________

最近完成(2026年2月至3月)

通过允许列表验证和强化Docker Compose安全性修复了SQL注入漏洞(CIS Docker Benchmark 4.6)。在所有服务中添加了security_opt和cap_drop,将发现减少了86%。

Terraform、CloudFormation和Kubernetes安全强化(已解决101个发现)。

  • **完成** (2026年3月)

根容器修复、HEALTHCHECK添加和版本标记实现(解决了29个发现)。

硬编码秘密删除和OAuth2安全改进(解决了39个发现)。

CSRF保护、路径遍历预防和凭据日志记录修复(解决了30个发现)。

在所有HTTP操作中添加了缺失的请求超时(B113发现)。

修复了FAISS搜索初始化和实体类型处理问题。

代理启用状态现在在切换操作时正确地持久化到存储库。

当使用Helm chart进行全栈部署时,注册表UI现在可以正确呈现。

可搜索的下拉筛选器和审计日志统计仪表板。

重构mcpgw MCP服务器,以消除技术债务并使用注册表HTTP API。

为度量服务启用OTLP推送导出(Datadog、New Relic、Prometheus远程写入支持)。

将auth_type替换为auth_scheme,并为后端服务器身份验证和健康检查添加了加密凭据存储。

修复了ECS部署中破坏Lua指标刷新和Python健康检查器的双栈DNS问题。

添加了Claude技能,用于macOS快速启动安装,包括交互式设置和拆卸。

有关所有问题、功能请求和详细发布历史的完整列表,请访问:

______________________________________________________________________

许可证

此项目根据Apache-2.0许可证获得许可-请参阅 许可证 文件以获取详细信息。

______________________________________________________________________

⭐ 如果此存储库对您的组织有帮助,请为其加星!

开始使用 | 文档 | 贡献

目录标签

目录标签

AI开发工具PythonClaude本地部署MCP网关代理注册服务器注册A2A通信

支持客户端

ClaudeCursorClineVS Code

接入字段

传输方式(transport,传输协议)

stdio

鉴权方式(authType,认证方式)

oauth

运行时(runtime,运行环境)

Python

工具数量(toolCount,工具数)

0

资源数量(resourceCount,资源数)

0

提示词数量(promptCount,提示词数)

0

权限和风险

stdiooauth部署方式未说明

接入前请确认传输方式、认证方式和部署位置,并根据实际工具能力限制访问范围。

安装前确认

不要直接授予不必要的文件、网络或账号权限;先核对安装命令和配置内容。

来源信息

继续浏览同类 MCP