Enterprise-ready MCP Gateway & Registry providing unified access to AI tools with OAuth authentication, dynamic tool discovery, and A2A communication. Integrates with VS Code/Cursor, ideal for enterprise AI governance and multi-agent collaboration.
Project Overview#
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.
Core Capabilities#
Three Core Functions#
- Unified MCP Server Gateway: Centralized MCP server access point
- MCP Servers Registry: MCP server registration, discovery, and management with unified governance
- Agent Registry & A2A Communication Hub: Agent registration, discovery, governance, and direct agent-to-agent communication via A2A protocol
Authentication & Security#
- OAuth 2.0/3.0 integration with Keycloak, Microsoft Entra ID (Azure AD), Amazon Cognito
- Fine-grained access control (tool-level, method-level, team-level)
- JWT Token generation and validation
- Static Token Auth for CI/CD pipelines and CLI tools
- Audit logging (SOC 2/GDPR compliance)
- Cisco AI Defense security scanning integration
Dynamic Tool Discovery#
- Runtime MCP server and tool enumeration
- AI-driven tool recommendation and selection
- Semantic search support (vectorized search with HNSW)
Multi-Protocol Support#
- SSE (Server-Sent Events)
- Streamable HTTP
- A2A Protocol
Architecture Components#
- Nginx Reverse Proxy: Reverse proxy router with Lua scripting support
- Auth Server: Dual authentication server (human users and M2M)
- Registry Web UI: React-based web management interface
- Registry MCP Server: The registry itself as an MCP server
- Database: MongoDB (local) / Amazon DocumentDB (production with HNSW vector search)
Deployment Modes#
- Full Mode: Complete gateway + registry functionality
- Registry-Only Mode: Standalone catalog/discovery service
- Skills-Only Mode: Manage Agent Skills only
- MCP-Servers-Only Mode: Manage MCP servers only
- Agents-Only Mode: Manage A2A agents only
Quick Start#
# Clone and configure
git clone https://github.com/agentic-community/mcp-gateway-registry.git
cd mcp-gateway-registry
cp .env.example .env
nano .env # Set KEYCLOAK_ADMIN_PASSWORD
# Deploy with prebuilt images
export DOCKERHUB_ORG=mcpgateway
./build_and_run.sh --prebuilt
# Access Registry UI
open http://localhost:7860
Use Cases#
- Enterprise Integration: Unified access point, enterprise SSO, compliance & governance, scalable architecture
- AI Agent Workflows: Dynamic tool discovery, intelligent tool selection, multi-agent coordination
- Development Teams: IDE integration (VS Code/Cursor/Claude Code), real-time collaboration
Development Info#
- Languages: Python (68.6%), TypeScript (15.1%), Shell (9.7%), HCL (2.8%), HTML (2.7%), Lua (0.6%)
- License: Apache-2.0
- Maintainer: agentic-community
- Version: v1.0.15
- Activity: 760+ commits, 29+ contributors