/ Каталог / Песочница / MCPJungle
● Сообщество mcpjungle ⚡ Сразу

MCPJungle

автор mcpjungle · mcpjungle/MCPJungle

Один Go-бинарник, один эндпоинт — подключите Claude / Cursor / любой MCP-клиент ко всем вашим MCP-серверам сразу. Самый простой агрегатор MCP.

MCPJungle — небольшой быстрый Go-агрегатор: зарегистрируйте N upstream MCP-серверов, получите один составной эндпоинт для клиентов. Инструменты разграничены по upstream, поддерживаются транспорты stdio и HTTP, поставляется как единый статический бинарник или Docker-образ. Полезно, когда вы переросли редактирование 8 разных путей в claude_desktop_config.json, но не нуждаетесь в корпоративной платформе вроде Archestra.

Зачем использовать

Ключевые функции

Живое демо

Как выглядит на практике

mcpjungle-mcp.replay ▶ готово
0/0

Установка

Выберите клиент

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "mcpjungle-mcp": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "-p",
        "9090:9090",
        "ghcr.io/mcpjungle/mcpjungle:latest"
      ]
    }
  }
}

Откройте Claude Desktop → Settings → Developer → Edit Config. Перезапустите после сохранения.

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "mcpjungle-mcp": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "-p",
        "9090:9090",
        "ghcr.io/mcpjungle/mcpjungle:latest"
      ]
    }
  }
}

Cursor использует ту же схему mcpServers, что и Claude Desktop. Конфиг проекта приоритетнее глобального.

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "mcpjungle-mcp": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "-p",
        "9090:9090",
        "ghcr.io/mcpjungle/mcpjungle:latest"
      ]
    }
  }
}

Щёлкните значок MCP Servers на боковой панели Cline, затем "Edit Configuration".

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "mcpjungle-mcp": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "-p",
        "9090:9090",
        "ghcr.io/mcpjungle/mcpjungle:latest"
      ]
    }
  }
}

Тот же формат, что и Claude Desktop. Перезапустите Windsurf для применения.

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "mcpjungle-mcp",
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "-p",
        "9090:9090",
        "ghcr.io/mcpjungle/mcpjungle:latest"
      ]
    }
  ]
}

Continue использует массив объектов серверов, а не map.

~/.config/zed/settings.json
{
  "context_servers": {
    "mcpjungle-mcp": {
      "command": {
        "path": "docker",
        "args": [
          "run",
          "--rm",
          "-i",
          "-p",
          "9090:9090",
          "ghcr.io/mcpjungle/mcpjungle:latest"
        ]
      }
    }
  }
}

Добавьте в context_servers. Zed перезагружается автоматически.

claude mcp add mcpjungle-mcp -- docker run --rm -i -p 9090:9090 ghcr.io/mcpjungle/mcpjungle:latest

Однострочная команда. Проверить: claude mcp list. Удалить: claude mcp remove.

Сценарии использования

Реальные сценарии: MCPJungle

Как свести 8 MCP-записей в одну строку клиентского конфига

👤 Продвинутые пользователи с множеством MCP в Claude Desktop / Cursor ⏱ ~20 min intermediate

Когда использовать: Ваш claude_desktop_config.json разросся до 200 строк и редактировать его больно.

Предварительные требования
  • MCPJungle запущен локальноdocker run -p 9090:9090 ghcr.io/mcpjungle/mcpjungle:latest или скачайте бинарник
Поток
  1. Зарегистрировать upstream-серверы
    Register github, postgres, filesystem, fetch, and time as upstream MCPs in MCPJungle.✓ Скопировано
    → 5 upstream-серверов в списке; tool_namespaces показывает их
  2. Переключить клиент
    Replace my 5 entries in claude_desktop_config.json with one entry pointing at MCPJungle on localhost:9090.✓ Скопировано
    → Одна MCP-запись; Claude видит инструменты всех 5 серверов через неё
  3. Проверить маршрутизацию
    Run a github tool and a postgres tool — confirm both reach their respective upstreams.✓ Скопировано
    → Оба успешны; логи показывают корректную маршрутизацию

Итог: Чище клиентский конфиг, те же возможности, та же задержка.

Подводные камни
  • Два upstream-сервера предоставляют инструменты с одинаковым именем — MCPJungle автоматически добавляет префикс по upstream: github.search_repositories против gitlab.search_repositories

Общий командный MCPJungle: разработчики разделяют одну курированную коллекцию MCP

👤 Небольшие команды (2–10 разработчиков) ⏱ ~60 min advanced

Когда использовать: Все устанавливают слегка разные версии MCP; единый командный эндпоинт устраняет расхождения.

Предварительные требования
  • Общий хост (небольшая VM или dev-сервер) — Запустите mcpjungle в Docker; откройте порт 9090 через Tailscale или VPN
Поток
  1. Запустить общий экземпляр
    Deploy MCPJungle on the team VM via docker compose. Bind to 100.x.x.x:9090 (Tailscale).✓ Скопировано
    → Сервис отвечает по командному URL
  2. Зафиксировать версии upstream
    Add github + filesystem + postgres MCPs at specific versions. Save the registration as a YAML file in the team repo.✓ Скопировано
    → registered.yaml зафиксирован; одинаков на всех машинах

Итог: Вся команда использует одинаковые версии и инструменты MCP.

Подводные камни
  • Общий MCP разделяет credentials — все, кто использует эндпоинт, могут их применять — Не помещайте MCP с правами записи в общий экземпляр, если вы не принимаете этот риск
Сочетать с: github

Добавлять и удалять MCP без перезапуска Claude

👤 Разработчики, экспериментирующие с новыми MCP-серверами ⏱ ~5 min beginner

Когда использовать: Вы хотите попробовать новый MCP, не выходя из Claude и не редактируя конфиг.

Поток
  1. Добавить горячо
    Register a new MCP arxiv upstream into MCPJungle without restarting.✓ Скопировано
    → Инструменты появляются при следующем обновлении сессии Claude
  2. Удалить горячо
    Unregister the slack MCP, since I'm done with that experiment.✓ Скопировано
    → Инструменты slack больше не в списке

Итог: Более быстрый цикл итерации с MCP.

Подводные камни
  • Некоторые клиенты кэшируют список инструментов — Перезагрузите разговор в Claude Desktop для обновления

Комбинации

Сочетайте с другими MCP — эффект x10

mcpjungle-mcp + github

Хранить registered.yaml как код, чтобы командный конфиг версионировался

mcpjungle-mcp + filesystem

Сохранять регистрации при старте

Инструменты

Что предоставляет этот MCP

ИнструментВходные данныеКогда вызыватьСтоимость
register name, transport: 'stdio'|'http', command_or_url, env Добавить upstream MCP бесплатно
unregister name Удалить upstream MCP бесплатно
list_upstreams (нет) Посмотреть, что зарегистрировано бесплатно
<upstream>.<tool> зависит от инструмента Вызвать любой инструмент любого зарегистрированного upstream 1 вызов upstream

Стоимость и лимиты

Во что обходится

Квота API
Нет (проксирует upstream)
Токенов на вызов
Минимальный overhead
Деньги
Бесплатно (MIT)
Совет
Запускайте на наименьшем сервере, который подходит по памяти для ваших upstream

Безопасность

Права, секреты, радиус поражения

Хранение учётных данных: Переменные среды, передаваемые в дочерние процессы upstream
Исходящий трафик: Аналогично upstream MCP

Устранение неполадок

Частые ошибки и исправления

Upstream зарегистрирован, но инструменты не отображаются

MCPJungle запрашивает список инструментов один раз при регистрации — перезапустите upstream, если он объявляет инструменты динамически

Проверить: Запустите upstream отдельно с `mcptools list` и убедитесь, что инструменты отображаются
Зомби-процесс stdio upstream

MCPJungle завершает подпроцессы при отмене регистрации — если сервер завис, перезапустите MCPJungle

Проверить: ps aux | grep <server>
Клиент сообщает «конфликт имён инструментов»

MCPJungle задаёт пространство имён по upstream — вызывайте <upstream>.<tool>, а не просто <tool>

Альтернативы

MCPJungle в сравнении

АльтернативаКогда использоватьКомпромисс
ArchestraНужны SSO, аудит и политики поверх агрегацииArchestra корпоративный; MCPJungle легковесный
samanhappy/mcphubХотите более богатый веб-интерфейсMCPHub имеет UI; MCPJungle — только бинарник + API

Ещё

Ресурсы

📖 Читать официальный README на GitHub

🐙 Открытые задачи

🔍 Все 400+ MCP-серверов и Skills