metamcp

# 🚀 MetaMCP (MCP Aggregator, Orchestrator, Middleware, Gateway in one docker) <!-- omit in toc --> <div align="center"> <div align="center"> <a href="https://discord.gg/mNsyat7mFX" style="text-decoration: none;"> <img src="https://img.shields.io/badge/Discord-MetaMCP-5865F2?style=flat-square&logo=discord&logoColor=white" alt="Discord" style="max-width: 100%;"> </a> <a href="https://docs.metamcp.com" style="text-decoration: none;"> <img src="https://img.shields.io/badge/Documentation-docs.metamcp.com-blue?style=flat-square&logo=book" alt="Documentation" style="max-width: 100%;"> </a> <a href="https://opensource.org/licenses/MIT" style="text-decoration: none;"> <img src="https://img.shields.io/badge/License-MIT-yellow.svg?style=flat-square" alt="MIT License" style="max-width: 100%;"> </a> <a href="https://github.com/metatool-ai/metamcp/pkgs/container/metamcp" style="text-decoration: none;"> <img src="https://img.shields.io/badge/GHCR-available-green.svg?style=flat-square&logo=github" alt="GHCR" style="max-width: 100%;"> </a> <a href="https://deepwiki.com/metatool-ai/metamcp"><img src="https://img.shields.io/badge/DeepWiki-metatool--ai%2Fmetamcp-blue.svg?style=flat-square&logo=data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACwAAAAyCAYAAAAnWDnqAAAAAXNSR0IArs4c6QAAA05JREFUaEPtmUtyEzEQhtWTQyQLHNak2AB7ZnyXZMEjXMGeK/AIi+QuHrMnbChYY7MIh8g01fJoopFb0uhhEqqcbWTp06/uv1saEDv4O3n3dV60RfP947Mm9/SQc0ICFQgzfc4CYZoTPAswgSJCCUJUnAAoRHOAUOcATwbmVLWdGoH//PB8mnKqScAhsD0kYP3j/Yt5LPQe2KvcXmGvRHcDnpxfL2zOYJ1mFwrryWTz0advv1Ut4CJgf5uhDuDj5eUcAUoahrdY/56ebRWeraTjMt/00Sh3UDtjgHtQNHwcRGOC98BJEAEymycmYcWwOprTgcB6VZ5JK5TAJ+fXGLBm3FDAmn6oPPjR4rKCAoJCal2eAiQp2x0vxTPB3ALO2CRkwmDy5WohzBDwSEFKRwPbknEggCPB/imwrycgxX2NzoMCHhPkDwqYMr9tRcP5qNrMZHkVnOjRMWwLCcr8ohBVb1OMjxLwGCvjTikrsBOiA6fNyCrm8V1rP93iVPpwaE+gO0SsWmPiXB+jikdf6SizrT5qKasx5j8ABbHpFTx+vFXp9EnYQmLx02h1QTTrl6eDqxLnGjporxl3NL3agEvXdT0WmEost648sQOYAeJS9Q7bfUVoMGnjo4AZdUMQku50McDcMWcBPvr0SzbTAFDfvJqwLzgxwATnCgnp4wDl6Aa+Ax283gghmj+vj7feE2KBBRMW3FzOpLOADl0Isb5587h/U4gGvkt5v60Z1VLG8BhYjbzRwyQZemwAd6cCR5/XFWLYZRIMpX39AR0tjaGGiGzLVyhse5C9RKC6ai42ppWPKiBagOvaYk8lO7DajerabOZP46Lby5wKjw1HCRx7p9sVMOWGzb/vA1hwiWc6jm3MvQDTogQkiqIhJV0nBQBTU+3okKCFDy9WwferkHjtxib7t3xIUQtHxnIwtx4mpg26/HfwVNVDb4oI9RHmx5WGelRVlrtiw43zboCLaxv46AZeB3IlTkwouebTr1y2NjSpHz68WNFjHvupy3q8TFn3Hos2IAk4Ju5dCo8B3wP7VPr/FGaKiG+T+v+TQqIrOqMTL1VdWV1DdmcbO8KXBz6esmYWYKPwDL5b5FA1a0hwapHiom0r/cKaoqr+27/XcrS5UwSMbQAAAABJRU5ErkJggg==" alt="DeepWiki: MetaMCP"></a> </div> </div> > **📢 Update:** *[From the author: apologize for some recent maintainence delay, but will at least keep merging PRs, more background [here](recent-updates.md)]* **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 | [中文](./README_cn.md) ## 📋 Table of Contents <!-- omit in toc --> - [🎯 Use Cases](#-use-cases) - [📖 Concepts](#-concepts) - [🖥️ **MCP Server**](#️-mcp-server) - [🔐 **Environment Variables \& Secrets (STDIO MCP Servers)**](#-environment-variables--secrets-stdio-mcp-servers) - [🏷️ **MetaMCP Namespace**](#️-metamcp-namespace) - [🌐 **MetaMCP Endpoint**](#-metamcp-endpoint) - [⚙️ **Middleware**](#️-middleware) - [🔍 **Inspector**](#-inspector) - [✏️ **Tool Overrides \& Annotations**](#️-tool-overrides--annotations) - [🚀 Quick Start](#-quick-start) - [🐳 Run with Docker Compose (Recommended)](#-run-with-docker-compose-recommended) - [📦 Build development environment with Dev Containers (VSCode/Cursor)](#-build-development-environment-with-dev-containers-vscodecursor) - [💻 Local Development](#-local-development) - [🔌 MCP Protocol Compatibility](#-mcp-protocol-compatibility) - [🔗 Connect to MetaMCP](#-connect-to-metamcp) - [📝 E.g., Cursor via mcp.json](#-eg-cursor-via-mcpjson) - [🖥️ Connecting Claude Desktop and Other STDIO-only Clients](#️-connecting-claude-desktop-and-other-stdio-only-clients) - [🔧 API Key Auth Troubleshooting](#-api-key-auth-troubleshooting) - [❄️ Cold Start Problem and Custom Dockerfile](#️-cold-start-problem-and-custom-dockerfile) - [🔐 Authentication](#-authentication) - [🔗 OpenID Connect (OIDC) Provider Support](#-openid-connect-oidc-provider-support) - [🛠️ **Configuration**](#️-configuration) - [🏢 **Supported Providers**](#-supported-providers) - [🔒 **Security Features**](#-security-features) - [📱 **Usage**](#-usage) - [⚙️ Registration Controls](#️-registration-controls) - [🎛️ **Available Controls**](#️-available-controls) - [🏢 **Enterprise Use Cases**](#-enterprise-use-cases) - [🛠️ **Configuration**](#️-configuration-1) - [🌐 Custom Deployment and SSE conf for Nginx](#-custom-deployment-and-sse-conf-for-nginx) - [🏗️ Architecture](#️-architecture) - [📊