MetaMCP
A proxy server that unifies multiple MCP servers, enabling seamless tool, prompt, and resource management via the MetaMCP App.
What is MetaMCP?
MetaMCP is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to proxy server that unifies multiple mcp servers, enabling seamless tool, prompt, and resource management via the metamcp app.
A proxy server that unifies multiple MCP servers, enabling seamless tool, prompt, and resource management via the MetaMCP App.
This server falls under the Developer Tools category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- A proxy server that unifies multiple MCP servers, enabling s
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 proxy MCP server that aggregates multiple MCP servers into a single unified connection, managed through the MetaMCP App web interface. Instead of configuring each MCP server individually in every AI client you use, you configure all your servers once in the MetaMCP App and point your clients at the single MetaMCP endpoint. It supports tool, prompt, and resource aggregation with namespace isolation, workspace-based configuration switching, and both stdio and SSE transports — making it a powerful middleware layer for users who run many MCP servers across multiple clients.
Prerequisites
- Node.js and npm installed (for npx)
- A MetaMCP account and API key from the MetaMCP App (https://metamcp.com)
- An MCP client such as Claude Desktop, Claude Code, or any MCP-compatible client
- The underlying MCP servers you want to aggregate must be installed and working individually
Sign up for MetaMCP and get your API key
Go to the MetaMCP App, create an account, and generate an API key from your account dashboard. You will use this key to authenticate the proxy server.
Configure your MCP servers in the MetaMCP App
Through the MetaMCP App web UI, add each MCP server you want to unify — specifying their commands, arguments, and environment variables. MetaMCP will manage launching and proxying them.
Add MetaMCP to your MCP client config
Replace individual MCP server entries in your client config with a single MetaMCP entry. All servers configured in the MetaMCP App will be accessible through this one connection.
{
"mcpServers": {
"MetaMCP": {
"command": "npx",
"args": ["-y", "@metamcp/mcp-server-metamcp@latest"],
"env": {
"METAMCP_API_KEY": "your-metamcp-api-key"
}
}
}
}Or use SSE transport for persistent connections
For environments where a long-running SSE server is preferable (such as Docker or a homelab server), start MetaMCP in SSE mode.
npx -y @metamcp/mcp-server-metamcp@latest \
--metamcp-api-key your-api-key \
--transport sse \
--port 12006Restart your MCP client and verify
Restart Claude Desktop or your client. All tools from servers configured in the MetaMCP App should now appear as if they were natively available. Use the MetaMCP App to add, remove, or reconfigure servers without touching client config files.
MetaMCP Examples
Client configuration
Minimal Claude Desktop configuration — a single MetaMCP entry replaces all individual server entries.
{
"mcpServers": {
"MetaMCP": {
"command": "npx",
"args": ["-y", "@metamcp/mcp-server-metamcp@latest"],
"env": {
"METAMCP_API_KEY": "your-metamcp-api-key-here",
"METAMCP_API_BASE_URL": "https://api.metamcp.com"
}
}
}
}Prompts to try
Once MetaMCP aggregates your servers, you access all their tools transparently through your AI client.
- "List all available MCP tools across all my connected servers"
- "Use the filesystem server to read my project's README, then use the GitHub server to create an issue summarizing it"
- "Switch to my 'research' workspace configuration in MetaMCP"
- "What servers are currently connected through MetaMCP?"
- "Run a web search using the search server and save the results with the filesystem server"Troubleshooting MetaMCP
MetaMCP connects but shows no tools from configured servers
Verify your METAMCP_API_KEY is correct and your servers are marked as active in the MetaMCP App. Also confirm the underlying server packages are installed and their commands are valid — MetaMCP proxies to them, so if a server fails to start, its tools won't appear.
Tool name conflicts between aggregated servers
MetaMCP applies namespace isolation so tools from different servers are prefixed to avoid conflicts. Check the MetaMCP App's tool listing to see the namespaced names, and use the full namespaced name when invoking a specific tool.
Docker containers can't reach localhost servers through MetaMCP
Set USE_DOCKER_HOST=true in the MetaMCP env config. This rewrites localhost references to host.docker.internal so servers running on the Docker host are reachable from inside the container.
Frequently Asked Questions about MetaMCP
What is MetaMCP?
MetaMCP is a Model Context Protocol (MCP) server that proxy server that unifies multiple mcp servers, enabling seamless tool, prompt, and resource management via the metamcp app. 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 Apache 2.0 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.