🚀 MetaMCP (MCP Aggregator, Orchestrator, Middleware, Gateway in one docker)

📢 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
• 🚀 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

🎯 Use Cases

• 🏷️ Group MCP servers into namespaces, host them as meta-MCPs, and assign public endpoints (SSE or Streamable HTTP), with auth. One-click to switch a namespace for an endpoint.
• 🎯 Pick tools you only need when remixing MCP servers. Apply other pluggable middleware around observability, security, etc. (coming soon)
• 🔍 Use as enhanced MCP inspector with saved server configs, and inspect your MetaMCP endpoints in house to see if it works or not.
• 🔍 Use as Elasticsearch for MCP tool selection (coming soon)

Generally developers can use MetaMCP as infrastructure to host dynamically composed MCP servers through a unified endpoint, and build agents on top of it.

Quick demo video: https://youtu.be/Cf6jVd2saAs

📖 Concepts

🖥️ MCP Server

A MCP server configuration that tells MetaMCP how to start a MCP server.

"HackerNews": {
  "type": "STDIO",
  "command": "uvx",
  "args": ["mcp-hn"]
}

---

GitHub에서 전체 내용 보기