middleware

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. It functions as an MCP Aggregator, Orchestrator, Middleware, and Gateway all in one docker image, enabling scalable, configurable hosting of multiple MCP servers behind a single endpoint with flexible authentication, tooling, and annotations. This README introduces core concepts such as MCP Server configurations, Namespaces, Endpoints, Middleware, Inspector, and Tool Overrides & Annotations, and provides quick-start guidance for running MetaMCP with Docker, building a development environment, and integrating with clients like Claude Desktop via proxies. It also covers MCP protocol compatibility, authentication options (including API keys, OAuth, and OIDC), and integration guidance for developers looking to remix MCP tool flows and middleware pipelines.