MCPJungle README

The project's README from github.com/mcpjungle/MCPJungle. As one markdown file: 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)

Searching Database…

1.6K ·GitHub
MCPJungle
What is this?MCPJungle is a self-hosted MCP gateway. You register all your MCP servers in it once, and clients like Claude, Cursor, or your own agents connect to a single MCP endpoint instead of to each server separately.
Is it a server, a CLI, or a library I import into code?It's a server you run yourself, managed with a separate CLI. You don't import it into your code as a library.
How do I get it running?Fetch the docker-compose.yaml and start the server with docker compose. It exposes an MCP endpoint over streamable HTTP. Then install the CLI, add an MCP server (the README uses context7 as the example), and add mcpjungle to your Claude Desktop config.
What do I need before starting?Docker, to run the server with docker compose, and the mcpjungle CLI, installed with brew or downloaded from the Releases Page. The README lists no other prerequisites.
What should I watch out for?The README says the docs site is the up-to-date source, so check docs.mcpjungle.com for current guides and operational details instead of relying on this README alone.
Is it for just me or for a whole team?Both. You can start with a personal local setup to keep your MCP configuration clean, then run it as shared team infrastructure with centralized discovery, access control, and observability.
Can I limit which tools a given client sees?Yes. Optional tool groups expose only the tools a specific client should see, so one shared gateway can serve different clients with different scopes.
Does it manage prompts and resources, or only tools?It provides unified discovery for tools, prompts, and resources across all the MCP servers you register, so you don't have to check each server separately.
Why put a gateway in front of MCP servers at all?Without one, every AI client needs its own MCP configuration and access control gets duplicated or missing. A single control point makes the setup easier to reproduce and keeps access consistent.
What are similar projects?executor, casbin-gateway, busbar, bifrost, litellm, davinci-resolve-mcp, overmind, modelcontextprotocol
Which topics is it in?claude-desktop, mcp-gateway, access-control, ai-gateway, infrastructure, observability, model-context-protocol, cursor, developers, mcp-server, go, mcp
Creator
mcpjungle
Size
30.8 MB
Stars
1.6K
Updated
CommitNov 03Release0.4.7Oct 30
Age
1y
Commits · 90 Days