Metamcp
MCP Aggregator, Orchestrator, Middleware, Gateway in one docker
What is Metamcp?
Metamcp is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to mcp aggregator, orchestrator, middleware, gateway in one docker
MCP Aggregator, Orchestrator, Middleware, Gateway in one docker
This server falls under the Developer Tools category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- MCP Aggregator, Orchestrator, Middleware, Gateway in one doc
Use Cases
Maintainer
Works with
Installation
NPM
npx -y @metamcp/mcp-server-metamcpManual Installation
npx -y @metamcp/mcp-server-metamcpConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Metamcp
MetaMCP is a self-hosted Docker-based platform that acts as an MCP aggregator, orchestrator, middleware layer, and API gateway in one deployment. It lets you register multiple MCP servers through a web UI, organize them into named endpoints, and expose them to any MCP client via SSE or Streamable HTTP — including Claude Desktop, Cursor, and n8n. It also supports OAuth-enabled MCP servers, converts MCP tools to OpenAPI endpoints, and provides OIDC-based access control so teams can share a single MCP gateway securely.
Prerequisites
- Docker and Docker Compose installed
- Node.js 18+ (for local development only, not required for Docker)
- An MCP client such as Claude Desktop, Cursor, or Claude Code
- Optional: OIDC provider credentials (client-id, client-secret, discovery URL) for team access control
Clone the repository and set up environment
Clone MetaMCP and copy the example environment file. Edit .env to set your APP_URL and any OIDC credentials.
git clone https://github.com/metatool-ai/metamcp.git
cd metamcp
cp example.env .envConfigure environment variables
Edit .env with at minimum the APP_URL. For team deployments add OIDC settings.
# .env
APP_URL=http://localhost:12008
LOG_LEVEL=info
# Optional OIDC:
OIDC_CLIENT_ID=your-client-id
OIDC_CLIENT_SECRET=your-client-secret
OIDC_DISCOVERY_URL=https://your-provider/.well-known/openid-configuration
OIDC_SCOPES=openid email profile
OIDC_PKCE=trueStart MetaMCP with Docker Compose
Launch all services including the MetaMCP app and PostgreSQL database.
docker compose up -dRegister MCP servers in the web UI
Open http://localhost:12008 in your browser. Add MCP servers through the UI — for example a HackerNews server using uvx mcp-hn. Create a named endpoint that aggregates the servers you want.
Connect Claude Desktop via mcp-proxy
Claude Desktop does not support SSE natively, so use mcp-proxy as a bridge. Replace ENDPOINT_NAME with your endpoint name and YOUR_API_KEY_HERE with the sk_mt_... key from the MetaMCP UI.
{
"mcpServers": {
"MetaMCP": {
"command": "uvx",
"args": [
"mcp-proxy",
"--transport",
"streamablehttp",
"http://localhost:12008/metamcp/ENDPOINT_NAME/mcp"
],
"env": {
"API_ACCESS_TOKEN": "sk_mt_YOUR_KEY_HERE"
}
}
}
}Connect Cursor or other SSE-capable clients
SSE-capable clients like Cursor can connect directly without mcp-proxy.
{
"mcpServers": {
"MetaMCP": {
"url": "http://localhost:12008/metamcp/ENDPOINT_NAME/sse"
}
}
}Metamcp Examples
Client configuration
Claude Desktop configuration connecting to MetaMCP via mcp-proxy with Streamable HTTP transport.
{
"mcpServers": {
"MetaMCP": {
"command": "uvx",
"args": [
"mcp-proxy",
"--transport",
"streamablehttp",
"http://localhost:12008/metamcp/my-endpoint/mcp"
],
"env": {
"API_ACCESS_TOKEN": "sk_mt_your_api_key_here"
}
}
}
}Prompts to try
Example prompts once your MCP servers are aggregated through MetaMCP.
- "List all tools available through MetaMCP"
- "Show me the top stories on Hacker News right now"
- "What MCP servers are registered in my MetaMCP gateway?"
- "Search for issues in my GitHub repository using the tools available"
- "Fetch and summarize the content from a URL using my aggregated tools"Troubleshooting Metamcp
Docker Compose fails to start because the database is not ready
MetaMCP's app container may start before PostgreSQL is healthy. Run 'docker compose up -d' again after a few seconds, or add a healthcheck-based depends_on to your docker-compose.yml.
API_ACCESS_TOKEN is rejected with 401 Unauthorized
API keys follow the format sk_mt_... and are generated in the MetaMCP web UI under Settings → API Keys. Ensure you are copying the full key including the sk_mt_ prefix.
Claude Desktop cannot connect even with mcp-proxy configured
Verify MetaMCP is running: open http://localhost:12008 in a browser. Confirm the ENDPOINT_NAME in your config matches exactly what is shown in the MetaMCP UI. Ensure mcp-proxy is installed: run 'uvx mcp-proxy --help' to check.
Frequently Asked Questions about Metamcp
What is Metamcp?
Metamcp is a Model Context Protocol (MCP) server that mcp aggregator, orchestrator, middleware, gateway in one docker It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Metamcp?
Install via npm with the command: npx -y @metamcp/mcp-server-metamcp. Then add the server configuration to your AI client's JSON config file (e.g., claude_desktop_config.json or .cursor/mcp.json).
Which AI clients work with Metamcp?
Metamcp works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Metamcp free to use?
Yes, Metamcp is open source and available under the MIT license. You can use it freely in both personal and commercial projects.
Metamcp Alternatives — Similar Developer Tools Servers
Looking for alternatives to Metamcp? Here are other popular developer tools servers you can use with Claude, Cursor, and VS Code.
Ecc
★ 188.2kThe agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.
Javaguide
★ 155.8kJava 面试 & 后端通用面试指南，覆盖计算机基础、数据库、分布式、高并发、系统设计与 AI 应用开发
Gemini CLI
★ 104.5kA secure MCP server that wraps the Google Gemini CLI, allowing clients to query Gemini models using local OAuth sessions without requiring an API key. It provides tools for model interaction and diagnostics with built-in protection against command in
Awesome MCP Servers
★ 87.3k⭐ Curated list of Model Context Protocol (MCP) servers - tools that extend Claude Desktop, Cursor, Windsurf, and other MCP clients with custom capabilities.
MCP Servers
★ 86.0kModel Context Protocol Servers
CC Switch
★ 77.5kA cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Gemini CLI & Hermes Agent. Only official website: ccswitch.io
Browse More Developer Tools MCP Servers
Explore all developer tools servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Metamcp in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Metamcp?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.