---
title: "MetaMCP Documentation"
description: "MCP Aggregator, Orchestrator, Middleware, Gateway in one docker"
---

<div align="center">

<img src="/images/metamcp.svg" alt="MetaMCP Diagram" style={{ width: "100%", maxWidth: "600px", margin: "2rem 0" }} />

**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.

</div>

## 🎯 Use Cases

<CardGroup cols={2}>
  <Card title="Group & Host MCP Servers" icon="folder-open">
    Group MCP servers into namespaces, host them as meta-MCPs, and assign public endpoints (SSE or Streamable HTTP) with authentication.
  </Card>
  <Card title="Cherry-pick Tools" icon="pointer">
    Pick only the tools you need when remixing MCP servers. Apply pluggable middleware for observability and security.
  </Card>
  <Card title="Enhanced Inspector" icon="search-code">
    Use as enhanced MCP inspector with saved server configs, and inspect your MetaMCP endpoints.
  </Card>
  <Card title="Context Engineering Engine for MCP" icon="search">
    Use as Elasticsearch for MCP tool selection (coming soon).
  </Card>
</CardGroup>

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

<div align="center">
  <img src="/images/metamcp_screenshot.png" alt="MetaMCP Screenshot" style={{ width: "100%", maxWidth: "800px", margin: "2rem 0", borderRadius: "8px", boxShadow: "0 4px 6px rgba(0, 0, 0, 0.1)" }} />
</div>

## Quick Start

Get MetaMCP running in minutes with Docker Compose:

<CodeGroup>
```bash Clone & Setup
git clone https://github.com/metatool-ai/metamcp.git
cd metamcp
cp example.env .env
```

```bash Start with Docker
docker compose up -d
```
</CodeGroup>

<Card title="Continue with Quickstart Guide" icon="rocket" href="/en/quickstart">
  Follow our complete setup guide to configure your first MCP servers and namespaces.
</Card>

## Core Concepts

Understanding these key concepts will help you get the most out of MetaMCP:

<CardGroup cols={2}>
  <Card title="MCP Servers" icon="server" href="/en/concepts/mcp-servers">
    Learn how to configure and manage MCP server instances.
  </Card>
  <Card title="Namespaces" icon="package" href="/en/concepts/namespaces">
    Group MCP servers and apply middleware at the namespace level.
  </Card>
  <Card title="Endpoints" icon="globe" href="/en/concepts/endpoints">
    Create public endpoints for your namespaces with different transport options.
  </Card>
  <Card title="Middleware" icon="filter" href="/en/concepts/middleware">
    Transform MCP requests and responses with pluggable middleware.
  </Card>
</CardGroup>

## Integrations

Connect MetaMCP to your favorite tools and platforms:

<CardGroup cols={2}>
  <Card title="Cursor" icon="mouse-pointer-2" href="/en/integrations/cursor">
    Configure Cursor to use MetaMCP endpoints via mcp.json
  </Card>
  <Card title="Claude Desktop" icon="monitor-dot" href="/en/integrations/claude-desktop">
    Connect Claude Desktop using mcp-proxy for STDIO compatibility
  </Card>
</CardGroup>

## Features

<AccordionGroup>
  <Accordion icon="shield" title="Enterprise Authentication">
    - Better Auth for frontend & backend
    - Session cookies for secure connections
    - API key authentication for external access
    - OpenID Connect (OIDC) support for enterprise SSO
    - Multi-tenancy with public/private scopes
  </Accordion>

  <Accordion icon="network" title="Multiple Transport Options">
    - **SSE (Server-Sent Events)** for MCP backward compatibility and real-time connections
    - **Streamable HTTP** for Streamable HTTP-based MCP communication (now standard remote MCP connection)
    - **OpenAPI endpoints** compatible with clients like Open WebUI
    - **STDIO compatibility** via proxy for local
  </Accordion>

  <Accordion icon="globe" title="Internationalization">
    - Built-in support for English and Chinese
    - Easy to add additional languages
    - Locale-based routing and content
  </Accordion>

  <Accordion icon="chart-line" title="Performance & Scalability">
    - Pre-allocated idle sessions for reduced cold start time
    - Configurable session management
    - Designed for at least 2GB-4GB memory instances
    - Docker-based deployment with nginx support
    - Cluster scaling and separation of MCP manager and worker will release in the future.
  </Accordion>
</AccordionGroup>

## Getting Help

<CardGroup cols={2}>
  <Card title="Contributing to MetaMCP" icon="code" href="/en/development/contributing">
    Set up a local development environment and contribute to MetaMCP.
  </Card>
   <Card title="API Reference" icon="book" href="/en/api-reference/introduction">
    Explore the complete API documentation for MetaMCP endpoints.
  </Card>
  <Card title="GitHub Issues" icon="github" href="https://github.com/metatool-ai/metamcp/issues">
    Report bugs, request features, or browse existing issues.
  </Card>
  <Card title="Discord Community" icon="discord" href="https://discord.gg/mNsyat7mFX">
    Join our Discord server for support and community discussions.
  </Card>
</CardGroup>
