MetaMCP MCP Server

https://metamcp.com: The One MCP to manage all your MCPs

MetaMCP MCP Server is a proxy server that joins multiple MCP⁠ servers into one. It fetches tool/prompt/resource configurations from MetaMCP App⁠ and routes tool/prompt/resource requests to the correct underlying server.

MetaMCP App repo: https://github.com/metatool-ai/metatool-app

Installation

Installing via Smithery

The installation from Smithery doesn't work on cloud yet. Please install manually for now.

Manual Installation

export METAMCP_API_KEY=
npx -y @metamcp/mcp-server-metamcp@latest

{
  "mcpServers": {
    "MetaMCP": {
      "command": "npx",
      "args": ["-y", "@metamcp/mcp-server-metamcp@latest"],
      "env": {
        "METAMCP_API_KEY": ""
      }
    }
  }
}

Highlights

• Compatible with ANY MCP Client
• Multi-Workspaces layer enables you to switch to another set of MCP configs within one-click.
• GUI dynamic updates of MCP configs.
• Namespace isolation for joined MCPs.

Environment Variables

• METAMCP_API_KEY: Required. Obtained from MetaMCP App's "API Keys" page (https://metamcp.com/api-keys).
• METAMCP_API_BASE_URL: Optional override for MetaMCP App URL (e.g. http://localhost:12005).

Command Line Arguments

You can configure the API key and base URL using command line arguments:

npx -y @metamcp/mcp-server-metamcp@latest --metamcp-api-key  --metamcp-api-base-url 

For help with all available options:

npx -y @metamcp/mcp-server-metamcp@latest --help

These command line arguments take precedence over environment variables.

Architecture Overview

sequenceDiagram
    participant MCPClient as MCP Client (e.g. Claude Desktop)
    participant MetaMCP-mcp-server as MetaMCP MCP Server
    participant MetaMCPApp as MetaMCP App
    participant MCPServers as Installed MCP Servers in Metatool App


            
        
            
                    MCPClient ->> MetaMCP-mcp-server: Request list tools
    MetaMCP-mcp-server ->> MetaMCPApp: Get tools configuration & status
    MetaMCPApp ->> MetaMCP-mcp-server: Return tools configuration & status

    loop For each listed MCP Server
        MetaMCP-mcp-server ->> MCPServers: Request list_tools
        MCPServers ->> MetaMCP-mcp-server: Return list of tools
    end

    MetaMCP-mcp-server ->> MetaMCP-mcp-server: Aggregate tool lists
    MetaMCP-mcp-server ->> MCPClient: Return aggregated list of tools

    MCPClient ->> MetaMCP-mcp-server: Call tool
    MetaMCP-mcp-server ->> MCPServers: call_tool to target MCP Server
    MCPServers ->> MetaMCP-mcp-server: Return tool response
    MetaMCP-mcp-server ->> MCPClient: Return tool response

Credits

• Inspirations and some code (refactored in this project) from https://github.com/adamwattis/mcp-proxy-server/