MCPJungle README

README проекта с github.com/mcpjungle/MCPJungle. Одним файлом markdown: README.md.

MCPJungle

Run all your MCP servers behind one endpoint

Documentation GHCR Discord

MCPJungle is a self-hosted MCP gateway for developers and teams who want to manage multiple MCP servers without scattered client configurations, duplicated setup, or inconsistent access control.

Use it locally to keep your personal MCP setup clean, or run it as shared infrastructure for a team with centralized discovery, access control, and observability.

diagram

Instead of wiring every MCP server into every AI client, register your servers once in MCPJungle and let Claude, Cursor, Codex, or your own Agents connect to a single MCP endpoint.

Why MCPJungle?

MCP is powerful, but managing many MCP servers gets messy fast.

Without a gateway:

MCPJungle gives you a single control point:

Start with a local setup. Scale to a shared team gateway when you need it.

MCPJungle dashboard UI

Documentation

Mcpjungle documentation has a new home: https://docs.mcpjungle.com.

Please prefer the docs site over this README for the latest guides, reference, and operational details.

Your AI Clients can also access the docs using its MCP server https://docs.mcpjungle.com/mcp!

Quickstart

This quickstart guide will show you how to:

  1. Start the mcpjungle server locally using docker compose
  2. Add an MCP server in mcpjungle
  3. Connect your Claude Desktop to mcpjungle to access your MCP tools

Start the server

Fetch the docker-compose.yaml and start the mcpjungle server:

curl -O https://raw.githubusercontent.com/mcpjungle/MCPJungle/refs/heads/main/docker-compose.yaml
docker compose up -d

This exposes mcpjungle's streamable http mcp server at http://localhost:8080/mcp by default.

Add an MCP server

  1. Download the mcpjungle CLI on your local machine either using brew or directly from the Releases Page.
brew install mcpjungle/mcpjungle/mcpjungle
  1. Add the context7 MCP server to mcpjungle using the CLI:
mcpjungle register --name context7 --url https://mcp.context7.com/mcp

You should see output similar to this:

register-context7

Connect to mcpjungle

In your Claude Desktop, add the configuration for mcpjungle MCP server:

{
  "mcpServers": {
    "mcpjungle": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "http://localhost:8080/mcp",
        "--allow-http"
      ]
    }
  }
}

Once you have added the configuration, try asking claude something simple:

Use context7 to get the documentation for `/lodash/lodash`

Claude will then attempt to call the context7__get-library-docs tool via MCPJungle, which will return the documentation for the Lodash library.

claude calls context7 tool via mcpjungle

You now have a working MCP setup with a single unified endpoint!

Next, explore the complete documentation at docs.mcpjungle.com and the public roadmap.

MCPJungle (mcpjungle/MCPJungle)

Ищем в базе…

Что это такое?MCPJungle — это MCP-шлюз, который вы разворачиваете у себя. Вы один раз регистрируете в нём все свои MCP-серверы, а клиенты вроде Claude, Cursor или ваши собственные агенты подключаются к одному MCP-эндпоинту вместо того, чтобы подключаться к каждому серверу отдельно.
Это сервер, CLI или библиотека, которую я импортирую в код?Это сервер, который вы запускаете сами, и управляется он через отдельный CLI. В свой код как библиотеку его импортировать не нужно.
Как его запустить?Скачайте docker-compose.yaml и запустите сервер командой docker compose. Он открывает MCP-эндпоинт через streamable HTTP. Затем установите CLI, добавьте MCP-сервер (в README в качестве примера используется context7) и добавьте mcpjungle в конфигурацию Claude Desktop.
Что нужно установить перед запуском?Docker, чтобы запустить сервер через docker compose, и CLI mcpjungle, который устанавливается через brew или скачивается со страницы Releases Page. Других требований в README не указано.
На что стоит обратить внимание?В README сказано, что актуальный источник — сайт с документацией, поэтому за свежими руководствами и сведениями об эксплуатации загляните на docs.mcpjungle.com, а не полагайтесь только на этот README.
Это для меня одного или для всей команды?Подходит и то и другое. Можно начать с личной локальной настройки, чтобы аккуратно хранить конфигурацию MCP, а потом запустить шлюз как общую инфраструктуру команды с централизованным обнаружением, контролем доступа и наблюдаемостью.
Можно ли ограничить, какие инструменты видит конкретный клиент?Да. Необязательные группы инструментов открывают только те инструменты, которые должен видеть конкретный клиент, поэтому один общий шлюз может обслуживать разных клиентов с разными правами.
Он управляет промптами и ресурсами или только инструментами?Он предоставляет единое обнаружение инструментов, промптов и ресурсов со всех зарегистрированных MCP-серверов, так что не нужно проверять каждый сервер по отдельности.
Зачем вообще ставить шлюз перед MCP-серверами?Без шлюза каждому AI-клиенту нужна собственная конфигурация MCP, а контроль доступа дублируется или отсутствует. Единая точка управления упрощает повторное развёртывание и обеспечивает одинаковый доступ для всех.
Какие есть похожие проекты?executor, busbar, casbin-gateway, bifrost, litellm, davinci-resolve-mcp, overmind, modelcontextprotocol
Автор
mcpjungle
Размер
30.8 MB
Звёзды
1.6K
Возраст
1 г
Коммиты · 90 дней