MetaMCP MCP-Server

Name: MetaMCP MCP Server
Author: metatool-ai

https://metamcp.com : Das eine MCP zur Verwaltung all Ihrer MCPs

Der MetaMCP MCP Server ist ein Proxyserver, der mehrere MCP-Server zu einem einzigen zusammenführt. Er ruft Tool-/Prompt-/Ressourcenkonfigurationen aus der MetaMCP-App ab und leitet Tool-/Prompt-/Ressourcenanfragen an den richtigen zugrunde liegenden Server weiter.

Schmiedeabzeichen

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

Installation

Installation über Smithery

Manchmal funktioniert Smithery (lokal in Windsurf bestätigt), manchmal ist es aber instabil, da MetaMCP die Besonderheit hat, andere MCPs darauf laufen zu lassen. Falls dies nicht funktioniert, ziehen Sie bitte eine manuelle Installation in Erwägung.

So installieren Sie den MetaMCP MCP-Server für Claude Desktop automatisch über Smithery :

npx -y @smithery/cli install @metatool-ai/mcp-server-metamcp --client claude

Manuelle Installation

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

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

Related MCP server: mcprouter

Verwendung

Verwendung als Stdio-Server (Standard)

mcp-server-metamcp --metamcp-api-key <your-api-key>

Verwendung als SSE-Server

mcp-server-metamcp --metamcp-api-key <your-api-key> --transport sse --port 12006

Mit der SSE-Transportoption startet der Server einen Express.js-Webserver, der am /sse -Endpunkt auf SSE-Verbindungen wartet und am /messages -Endpunkt Nachrichten akzeptiert.

Verwendung mit Docker

Wenn Sie den Server in einem Docker-Container ausführen und eine Verbindung zu Diensten auf dem Hostcomputer herstellen, verwenden Sie die Option --use-docker-host um Localhost-URLs automatisch zu transformieren:

mcp-server-metamcp --metamcp-api-key <your-api-key> --transport sse --port 12006 --use-docker-host

Dadurch werden alle localhost- oder 127.0.0.1-URLs in host.docker.internal umgewandelt, sodass der Container ordnungsgemäß eine Verbindung zu den auf dem Host ausgeführten Diensten herstellen kann.

Befehlszeilenoptionen

Options:
  --metamcp-api-key <key>       API key for MetaMCP (can also be set via METAMCP_API_KEY env var)
  --metamcp-api-base-url <url>  Base URL for MetaMCP API (can also be set via METAMCP_API_BASE_URL env var)
  --report                      Fetch all MCPs, initialize clients, and report tools to MetaMCP API
  --transport <type>            Transport type to use (stdio or sse) (default: "stdio")
  --port <port>                 Port to use for SSE transport (default: "12006")
  --require-api-auth            Require API key in SSE URL path
  --use-docker-host             Transform localhost URLs to use host.docker.internal (can also be set via USE_DOCKER_HOST env var)
  -h, --help                    display help for command

Umgebungsvariablen

METAMCP_API_KEY : API-Schlüssel für MetaMCP
METAMCP_API_BASE_URL : Basis-URL für die MetaMCP-API
USE_DOCKER_HOST : Wenn auf „true“ gesetzt, werden localhost-URLs zur Docker-Kompatibilität in host.docker.internal umgewandelt

Entwicklung

# Install dependencies
npm install

# Build the application
npm run build

# Watch for changes
npm run watch

Highlights

Kompatibel mit JEDEM MCP-Client
Mit der Multi-Workspaces-Ebene können Sie mit nur einem Klick zu einem anderen Satz von MCP-Konfigurationen wechseln.
Dynamische GUI-Updates von MCP-Konfigurationen.
Namespace-Isolierung für verbundene MCPs.

Architekturübersicht

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

Inspirationen und etwas Code (in diesem Projekt überarbeitet) von https://github.com/adamwattis/mcp-proxy-server/

MetaMCP MCP Server