MetaMCP MCP-сервер

Name: MetaMCP MCP Server
Author: metatool-ai

https://metamcp.com : Единый MCP для управления всеми вашими MCP

MetaMCP MCP Server — это прокси-сервер, который объединяет несколько серверов MCP⁠ в один. Он извлекает конфигурации инструментов/подсказок/ресурсов из MetaMCP App⁠ и направляет запросы инструментов/подсказок/ресурсов на правильный базовый сервер.

значок кузнеца

Репозиторий приложения MetaMCP: https://github.com/metatool-ai/metatool-app

Установка

Установка через Smithery

Иногда Smithery работает (подтверждено локально в Windsurf), но иногда он нестабилен, потому что MetaMCP особенный, он запускает другие MCP поверх себя. Пожалуйста, рассмотрите возможность ручной установки, если это не работает.

Чтобы автоматически установить MetaMCP MCP Server для Claude Desktop через Smithery :

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

Ручная установка

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

Использование

Использование в качестве stdio-сервера (по умолчанию)

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

Использование в качестве сервера SSE

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

При использовании опции транспорта SSE сервер запустит веб-сервер Express.js, который прослушивает соединения SSE на конечной точке /sse и принимает сообщения на конечной точке /messages .

Использование с Docker

При запуске сервера внутри контейнера Docker и подключении к службам на хост-машине используйте параметр --use-docker-host для автоматического преобразования URL-адресов localhost:

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

Это преобразует все URL-адреса localhost или 127.0.0.1 в host.docker.internal , что позволит контейнеру правильно подключаться к службам, работающим на хосте.

Параметры командной строки

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

Переменные среды

METAMCP_API_KEY : API-ключ для MetaMCP
METAMCP_API_BASE_URL : Базовый URL для API MetaMCP
USE_DOCKER_HOST : если установлено значение «true», URL-адреса localhost преобразуются в host.docker.internal для совместимости с Docker.

Разработка

# Install dependencies
npm install

# Build the application
npm run build

# Watch for changes
npm run watch

Основные моменты

Совместимо с ЛЮБЫМ клиентом MCP
Слой Multi-Workspaces позволяет переключаться на другой набор конфигураций MCP одним щелчком мыши.
Динамические обновления конфигураций MCP через графический интерфейс.
Изоляция пространства имен для присоединенных MCP.

Обзор архитектуры

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

Кредиты

Вдохновение и немного кода (рефакторинг которого выполнен в этом проекте) с https://github.com/adamwattis/mcp-proxy-server/

MetaMCP MCP Server