Connectors#Any agent#Coding #Deployment #Security

MCP gateway and registry for agent tools

MCP Gateway is a central hub for exposing tools, resources, and prompts to MCP-compatible agents. It adds authentication, rate limiting, server discovery, logging, and transport bridging so agents can use services through one controlled entry point.

41 stars•10 forks•Go•Updated 6mo ago

Who it's for

Builders who want their MCP agents to reach internal APIs and services through one managed gateway.

What it delivers

You can expose existing services to agents without wiring each one up by hand, while keeping access and activity visible.

What it does

REST to MCP translation

Wraps HTTP services as MCP tools with schema validation.

Server discovery and namespaces

Finds MCP servers automatically and groups them into isolated namespaces.

Authentication and policy controls

Supports JWT, OAuth2, OIDC, RBAC, API keys, and rate limiting.

Multi-protocol transport bridge

Handles JSON-RPC 2.0, WebSocket, SSE, streamable HTTP, and stdio.

Logging and auditing

Records requests, responses, sessions, and security events with metrics and alerts.

Virtual MCP servers

Builds virtual servers on top of REST APIs and other services.

How to get it

1Fast development with backend in Docker and frontend running locally

# Terminal 1: Start backend services
make dev

# Terminal 2: Start frontend locally (much faster)
cd apps/frontend
bun install
bun run dev

README

MCP Gateway

A production-ready API gateway for Model Context Protocol (MCP) servers, providing enterprise-grade infrastructure with authentication, logging, rate limiting, server discovery, and multi-protocol transport support.

🚀 Quick Start

Get the entire MCP Gateway stack running with a single command:

# Clone the repository
git clone https://github.com/mcp-gateway/mcp-gateway.git
cd mcp-gateway

# Copy env vars
cp .env.example .env

# Option 1: Using Docker Compose directly
docker compose up --build

# Option 2: Using Makefile (automatically detects docker compose vs docker-compose)
make setup

Access the application:

Backend: http://localhost:8080
Frontend: http://localhost:3000
Admin user: admin@admin.com / qwerty123

Architecture

The MCP Gateway is designed with a modular architecture for scalability and maintainability:

┌─────────────────┐    ┌─────────────────┐    ┌─────────────────┐
│      Users      │    │    AI Agents    │    │     AI Agents   │
│   (Web/Mobile)  │    │    (External)   │    │    (Internal)   │
└─────────┬───────┘    └─────────┬───────┘    └─────────┬───────┘
          │                      │                      │
          └──────────────────────┼──────────────────────┘
                                 │
                   ┌─────────────▼─────────────┐
                   │    MCP Gateway    │
                   │                           │
                   │  ┌─────────────────────┐  │
                   │  │   Security Layer    │  │
                   │  │ • JWT Auth          │  │
                   │  │ • RBAC & Policies   │  │
                   │  │ • API Key Mgmt      │  │
                   │  │ • Rate Limiting     │  │
                   │  └─────────────────────┘  │
                   │                           │
                   │  ┌─────────────────────┐  │
                   │  │     Middleware      │  │
                   │  │ • Content Filtering │  │
                   │  │ • Audit Logging     │  │
                   │  │ • CORS & Headers    │  │
                   │  │ • Request Tracking  │  │
                   │  └─────────────────────┘  │
                   │                           │
                   │  ┌─────────────────────┐  │
                   │  │   Core Services     │  │
                   │  │ • Server Discovery  │  │
                   │  │ • Namespace Manager │  │
                   │  │ • Transport Proxy   │  │
                   │  │ • Virtual Servers   │  │
                   │  │ • Logging & Metrics │  │
                   │  └─────────────────────┘  │
                   └─────────────┬─────────────┘
                                 │
          ┌──────────────────────┼──────────────────────┐
          │                      │                      │
    ┌──────▼──────┐        ┌──────▼──────┐        ┌──────▼──────┐
    │ namespace-1 │        │ namespace-2 │        │ namespace-3 │
    │             │        │             │        │             │
    │┌───────────┐│        │┌───────────┐│        │┌───────────┐│
    ││MCP Server ││        ││MCP Server ││        ││Virtual    ││
    ││     A     ││        ││     C     ││        ││Server A   ││
    │└───────────┘│        │└───────────┘│        │└───────────┘│
    │┌───────────┐│        │┌───────────┐│        │┌───────────┐│
    ││MCP Server ││        ││MCP Server ││        ││Virtual    ││
    ││     B     ││        ││     D     ││        ││Server B   ││
    │└───────────┘│        │└───────────┘│        │└───────────┘│
    └─────────────┘        └─────────────┘        └─────────────┘

Features

🔐 Security & Authentication

Authentication - Secure authentication (JWT, OAuth2, OIDC) with RBAC
API Key Management - Role-based access control with fine-grained permissions
Rate Limiting - IP-based limiting with Redis backing and memory fallback
Content Filtering - PII detection, regex patterns, and custom filters

🏢 Server & Namespace Management

Dynamic Discovery - Automatic MCP server discovery and registration
Namespaces - Group servers with isolated namespaces for internal & external usage
Health Monitoring - Server health checks with automated failover and recovery
Public Endpoints - Auto-generated REST APIs for namespace access

🔌 Multi-Protocol Transport

JSON-RPC 2.0 - Standard synchronous RPC over HTTP
WebSocket - Full-duplex bidirectional communication
Server-Sent Events - Real-time server-to-client streaming
Streamable HTTP - Official MCP protocol implementation
STDIO - Command-line interface bridge

🌐 Service Virtualization

Protocol Support - REST APIs, GraphQL (coming soon), gRPC (coming soon)
MCP Integration - Transform any HTTP service into MCP tools with schema validation
Example Integrations - Internal API docs, microservers, etc.

📊 Logging, Auditing & Metrics

Audit Trails - Complete request/response logging with security event tracking
Performance Metrics - Real-time monitoring with health checks and alerting
External Integration - AWS CloudWatch, file-based logging, and custom exporters
Session Tracking - Live session management with detailed interaction logs

🛠️ Development

Quick Development Setup

Fast development with backend in Docker and frontend running locally:

# Terminal 1: Start backend services
make dev

# Terminal 2: Start frontend locally (much faster)
cd apps/frontend
bun install
bun run dev

Essential Commands

# Development
make dev              # Start backend services (postgres, redis, backend)
make setup            # Complete setup (DB + admin + orgs + namespaces)
make start            # Production-ready local setup with services
make stop             # Stop all services
make clean            # Stop and remove all data
make logs             # View service logs
make help             # Show all available commands

# Database Operations
make migrate          # Run database migrations
make migrate-down     # Rollback migrations
make migrate-status   # Show migration status
make db-shell         # Open PostgreSQL shell

# Testing & Quality
make test             # Run all tests
make lint             # Run linters

# Build & Utilities
make build            # Build containers
make rebuild          # Rebuild and restart containers
make shell            # Open shell in backend container
make bash             # Open bash in backend container

Troubleshooting

Docker Compose Issues:

# The Makefile automatically detects your Docker Compose version
# Check what it's using:
make help  # Will work with either docker-compose or docker compose

# Manual check:
docker compose version    # Modern v2
docker-compose version    # Legacy v1

# If you get "command not found":
# Install Docker Desktop (includes Compose v2) or standalone Compose

Common Issues:

Port conflicts: Stop other services on ports 8080, 3000, 5432, 6379
Permission denied: Ensure Docker daemon is running
Build failures: Try make clean then make setup

🤝 Contributing

Fork the repository
Run make dev to start backend services
Run frontend locally: cd apps/frontend && bun run dev
Make your changes
Run make test and make lint
Submit a Pull Request

Please see our Contributing Guidelines for details.

Code of Conduct

This project follows the Contributor Covenant Code of Conduct.

📄 License

This project is licensed under the Apache License 2.0 - see the LICENSE file for details.

🔒 Security

Security is a top priority. Please review our Security Policy and report vulnerabilities responsibly.

🙏 Acknowledgments

Model Context Protocol for the core specification
All our contributors

Built with ❤️ for the MCP community

⭐ Star us on GitHub • 🐛 Report Bug • 💡 Request Feature

Files in the repo

Repository payload•25 top-level entries

.claude— Claude Code skills, agents, commands, hooks
.cursor— Cursor rules and settings
.github— GitHub workflows and templates
apps— 2 items
docs— Project documentation and examples.
logs— 1 item
scripts— Build, entrypoint, and test scripts for the gateway and transports.
.air.toml
.dockerignore
.env.example— Environment variables to set
.gitattributes
.gitignore
.go-version
.pre-commit-config.yaml
CLAUDE.md— Project instructions for Claude Code users.
CONTRIBUTING.md
docker-compose.dev.yml— Development container stack.
docker-compose.yml— Main container stack for local and production-style runs.
go.mod— Go module
go.sum
LICENSE— License
Makefile
railway.toml
README.md— The README
SECURITY.md

Discussion (0)

Ask about usage, or say what you built with it

No comments yet. Be the first to say what this is good for.

More connectors

DeusData/codebase-memory-mcpConnectors

High-performance code intelligence MCP server. Indexes codebases into a persistent knowledge graph — average repo in milliseconds. 158 languages, sub-ms queries, 99% fewer tokens. Single static binary, zero dependencies.

43k

lidge-jun/opencodexConnectors

Universal provider proxy for OpenAI Codex & Claude Code — use any LLM (Claude, Gemini, Grok, DeepSeek, Ollama…) with Codex CLI, App, SDK, and Claude Code

14k

okf-memory/

okf-agent-memory

okf-memory/okf-agent-memoryConnectors

Git-native persistent memory for AI coding agents. Implements Google OKF v0.2 with sub-300µs in-memory BM25 search, embedded MCP server, and progressive disclosure. Slashes token bloat by 80% with zero external databases or dependencies. Built in pure Go.

547

tirth8205/

code-review-graph

tirth8205/code-review-graphConnectors

Local-first code intelligence graph for MCP and CLI. Builds a persistent map of your codebase so AI coding tools read only what matters, with benchmarked context reductions on reviews and large-repo workflows.

31k

2akouwu/

reverify

2akouwu/reverifyConnectors

Stop your AI from making things up — it proposes, deterministic tools decide, every claim checked against ground truth with evidence. Grounded facts and context survive resets. Reverse engineering is the proving ground. MCP server + CLI.

1.1k

t8y2/dbxConnectors

20 MB lightweight cross-platform database client for 90+ databases, including MySQL, PostgreSQL, SQLite, Redis, MongoDB, DuckDB, SQL Server, and Dameng. Built-in AI, MCP Server, CLI, desktop and Docker. | 轻量级跨平台数据库管理工具，支持 MySQL、PostgreSQL、SQLite、Redis、MongoDB、达梦等 90+ 数据库，提供桌面端、Docker、CLI、内置 AI 助手和 MCP Server。

19k