🚀 MetaMCP (MCP Aggregator, Orchestrator, Middleware, Gateway in one docker)
📢 Latest Update: This ai-dev branch will be the forward onging dev branch which contains ai agent changes. Please test before you build the image based on this branch. There has been many PRs thanks to the community but merging and reviewing them has been a growing effort too. I decided to include ai changes. At least so far the core functionality works. There is also a community maintained fork (ty a lot!): https://github.com/Umbrella-IT-Group/metamcp
📢 Update: [From the author: apologize for some recent maintainence delay, but will at least keep merging PRs, more background here]
MetaMCP is a MCP proxy that lets you dynamically aggregate MCP servers into a unified MCP server, and apply middlewares. MetaMCP itself is a MCP server so it can be easily plugged into ANY MCP clients.
For more details, consider visiting our documentation site: https://docs.metamcp.com
English | 简体中文
📋 Table of Contents
- 🎯 Use Cases
- 📖 Concepts
- 🖥️ MCP Server
- 🔐 Environment Variables & Secrets (STDIO MCP Servers)
- 🏷️ MetaMCP Namespace
- 🌐 MetaMCP Endpoint
- ⚙️ Middleware
- 🔍 Inspector
- ✏️ Tool Overrides & Annotations
- 🖥️ MCP Server
- 🚀 Quick Start
- 🐳 Run with Docker Compose (Recommended)
- 📦 Build development environment with Dev Containers (VSCode/Cursor)
- 💻 Local Development
- 🔌 MCP Protocol Compatibility
- 🔗 Connect to MetaMCP
- 📝 E.g., Cursor via mcp.json
- 🖥️ Connecting Claude Desktop and Other STDIO-only Clients
- 🔧 API Key Auth Troubleshooting
- ❄️ Cold Start Problem and Custom Dockerfile
- 🧾 Log Levels
- 🔐 Authentication
- 🚦 Traffic Management
- 🚧 MCP Rate Limit
- 🔗 OpenID Connect (OIDC) Provider Support
- 🛠️ Configuration
- 🏢 Supported Providers
- 🔒 Security Features
- 📱 Usage
- ⚙️ Registration Controls
- 🎛️ Available Controls
- 🏢 Enterprise Use Cases
- 🛠️ Configuration
- 🌐 Custom Deployment and SSE conf for Nginx
- 🏗️ Architecture
- 📊 Sequence Diagram
- 🗺️ Roadmap
- 🌐 i18n
- 🤝 Contributing
- 📄 License
- 🙏 Credits
