MCP Gateway & Registry

Security & Safety 💻 Python ⚖️ Apache-2.0 🟢 Actively maintained
895 stars

MCP Gateway & Registry is an open-source control plane for AI assets like MCP servers, agents, and skills. It provides a single authenticated gateway for discovery, access control, and audit logging, solving the problem of scattered credentials and lack of governance. It is for developers, platform teams, and organizations adopting AI tools.

✨ Key features

  • Single authenticated gateway for all AI assets
  • Centralized registry with semantic and lexical search
  • Per-user egress authentication for OAuth MCP servers
  • Security scanning with fail-closed admission gate
  • External-registry federation (Anthropic, AWS, peers)
  • Audit logging and OpenTelemetry metrics

🎯 Use cases

  • Register and govern MCP servers behind one gateway
  • Enable agents to discover each other by capability
  • Connect coding assistants to tools via dynamic discovery
  • Onboard OAuth-protected SaaS MCP servers enterprise-wide
  • Define custom asset types like workflows or policies

📦 Installation

🧰 Requirements: Requires Kubernetes (EKS), ECS, or Docker Compose; MongoDB/DocumentDB; an identity provider (Keycloak, Entra ID, Okta, Auth0, Cognito, PingFederate).

git clone https://github.com/agentic-community/mcp-gateway-registry.git
cd mcp-gateway-registry
cp .env.example .env
Edit .env and set the required secrets (e.g. KEYCLOAK_ADMIN_PASSWORD, SECRET_KEY). · See docs/configuration.md for the full list.
nano .env
Deploy with pre-built images (pulled from Amazon ECR Public by default)
./build_and_run.sh --prebuilt
Open the Registry UI (served by nginx on port 80)
open http://localhost        # macOS  (Linux: xdg-open http://localhost)

🚀 Usage

# After installation, register an MCP server via the UI or API.
# Example using the Python client (from api/registry_client.py):
from registry_client import RegistryClient
client = RegistryClient(base_url='http://localhost', api_key='YOUR_API_KEY')
client.register_server(name='MyServer', url='http://backend:8080')

❓ FAQ

What asset types can I register?

The registry supports MCP servers, A2A agents, skills, and custom entity types defined by admins.

How does authentication work?

The gateway integrates with your identity provider via OAuth2/OIDC, and access is controlled by fine-grained scopes.

Can I deploy on AWS?

Yes, it supports Amazon EKS with Helm, Amazon ECS with Terraform, and Docker Compose on EC2.

Is there a UI?

Yes, the Registry UI is served by nginx on port 80 by default.

📊 Repository

Stars★ 895
Forks🍴 226
Open issues🐛 112
Last commit🕒 Sep 1, 2026
Created📅 May 2025
Language💻 Python
License⚖️ Apache-2.0

🤖 Overview, features, install steps and FAQ were generated from the project's README on Sep 4, 2026. Always check the original source before running commands.