MCP Gateway & Registry

企业级 MCP 网关与注册中心，提供统一的 AI 工具访问入口、OAuth 安全认证、动态工具发现和 A2A 通信能力，支持 VS Code/Cursor 集成。适用于企业 AI 开发环境治理、多代理协作系统和合规审计场景。

项目定位#

面向企业的 MCP (Model Context Protocol) 网关与注册中心，通过安全 OAuth 认证、动态工具发现和统一访问入口，集中管理 AI 开发工具，服务于自主 AI 代理和 AI 编程助手。

核心能力#

三大核心功能#

Unified MCP Server Gateway: 集中式 MCP 服务器访问点，所有 AI 代理通过网关访问后端服务
MCP Servers Registry: MCP 服务器注册、发现和管理，提供统一治理
Agent Registry & A2A Communication Hub: 代理注册、发现、治理及通过 A2A 协议的直接代理间通信

身份认证与安全#

OAuth 2.0/3.0 集成，支持 Keycloak、Microsoft Entra ID (Azure AD)、Amazon Cognito
细粒度访问控制（工具级、方法级、团队级）
JWT Token 生成和验证
Static Token Auth 用于 CI/CD 管道和 CLI 工具
审计日志记录（SOC 2/GDPR 合规）
Cisco AI Defense 安全扫描集成

动态工具发现#

运行时 MCP 服务器和工具枚举
AI 驱动的工具推荐和选择
语义搜索支持（向量化搜索，基于 HNSW）

多协议支持#

SSE (Server-Sent Events)
Streamable HTTP
A2A Protocol

架构组件#

Nginx Reverse Proxy: 反向代理路由器，支持 Lua 脚本扩展
Auth Server: 双重认证服务器（支持人类用户和 M2M）
Registry Web UI: 基于 React 的 Web 管理界面
Registry MCP Server: 注册表自身的 MCP 服务器
Database: MongoDB（本地）/ Amazon DocumentDB（生产，支持 HNSW 向量搜索）

部署模式#

Full Mode: 完整网关 + 注册表功能
Registry-Only Mode: 独立目录/发现服务
Skills-Only Mode: 仅管理 Agent Skills
MCP-Servers-Only Mode: 仅管理 MCP 服务器
Agents-Only Mode: 仅管理 A2A 代理

快速开始#

# 克隆和配置
git clone https://github.com/agentic-community/mcp-gateway-registry.git
cd mcp-gateway-registry
cp .env.example .env
nano .env  # 设置 KEYCLOAK_ADMIN_PASSWORD

# 使用预构建镜像部署
export DOCKERHUB_ORG=mcpgateway
./build_and_run.sh --prebuilt

# 访问 Registry UI
open http://localhost:7860

测试套件#

make test          # 运行所有测试
make test-unit     # 快速单元测试
make test-coverage # 覆盖率报告

适用场景#

企业集成: 统一访问点、企业 SSO、合规与治理、可扩展架构
AI 代理工作流: 动态工具发现、智能工具选择、多代理协调、上下文感知权限
开发团队生产力: IDE 集成 (VS Code/Cursor/Claude Code)、实时协作、环境管理

开发信息#

主要语言: Python (68.6%), TypeScript (15.1%), Shell (9.7%), HCL (2.8%), HTML (2.7%), Lua (0.6%)
开源协议: Apache-2.0 License
维护组织: agentic-community
当前版本: v1.0.15
仓库活跃度: 760+ commits, 29+ contributors