$git clone https://github.com/metatool-ai/metamcp</div>
| 1 | # 🚀 MetaMCP (MCP Aggregator, Orchestrator, Middleware, Gateway in one docker) <!-- omit in toc --> |
| 2 | |
| 3 | <div align="center"> |
| 4 | |
| 5 | <div align="center"> |
| 6 | <a href="https://discord.gg/mNsyat7mFX" style="text-decoration: none;"> |
| 7 | <img src="https://img.shields.io/badge/Discord-MetaMCP-5865F2?style=flat-square&logo=discord&logoColor=white" alt="Discord" style="max-width: 100%;"> |
| 8 | </a> |
| 9 | <a href="https://docs.metamcp.com" style="text-decoration: none;"> |
| 10 | <img src="https://img.shields.io/badge/Documentation-docs.metamcp.com-blue?style=flat-square&logo=book" alt="Documentation" style="max-width: 100%;"> |
| 11 | </a> |
| 12 | <a href="https://opensource.org/licenses/MIT" style="text-decoration: none;"> |
| 13 | <img src="https://img.shields.io/badge/License-MIT-yellow.svg?style=flat-square" alt="MIT License" style="max-width: 100%;"> |
| 14 | </a> |
| 15 | <a href="https://github.com/metatool-ai/metamcp/pkgs/container/metamcp" style="text-decoration: none;"> |
| 16 | <img src="https://img.shields.io/badge/GHCR-available-green.svg?style=flat-square&logo=github" alt="GHCR" style="max-width: 100%;"> |
| 17 | </a> |
| 18 | <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> |
| 19 | </div> |
| 20 | |
| 21 | </div> |
| 22 | |
| 23 | > **📢 Update:** *[From the author: apologize for some recent maintainence delay, but will at least keep merging PRs, more background [here](recent-updates.md)]* |
| 24 | |
| 25 | **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. |
| 26 | |
| 27 |  |
| 28 | |
| 29 | --- |
| 30 | |
| 31 | For more details, consider visiting our documentation site: https://docs.metamcp.com |
| 32 | |
| 33 | English | [中文](./README_cn.md) |
| 34 | ## 📋 Table of Contents <!-- omit in toc --> |
| 35 | |
| 36 | - [🎯 Use Cases](#-use-cases) |
| 37 | - [📖 Concepts](#-concepts) |
| 38 | - [🖥️ **MCP Server**](#️-mcp-server) |
| 39 | - [🔐 **Environment Variables \& Secrets (STDIO MCP Servers)**](#-environment-variables--secrets-stdio-mcp-servers) |
| 40 | - [🏷️ **MetaMCP Namespace**](#️-metamcp-namespace) |
| 41 | - [🌐 **MetaMCP Endpoint**](#-metamcp-endpoint) |
| 42 | - [⚙️ **Middleware**](#️-middleware) |
| 43 | - [🔍 **Inspector**](#-inspector) |
| 44 | - [✏️ **Tool Overrides \& Annotations**](#️-tool-overrides--annotations) |
| 45 | - [🚀 Quick Start](#-quick-start) |
| 46 | - [🐳 Run with Docker Compose (Recommended)](#-run-with-docker-compose-recommended) |
| 47 | - [📦 Build development environment with Dev Containers (VSCode/Cursor)](#-build-development-environment-with-dev-containers-vscodecursor) |
| 48 | - [💻 Local Development](#-local-development) |
| 49 | - [🔌 MCP Protocol Compatibility](#-mcp-protocol-compatibility) |
| 50 | - [🔗 Connect to MetaMCP](#-connect-to-metamcp) |
| 51 | - [📝 E |