Self-hosted MCP Server registry for your private AI agents

MCPJungle is a single source-of-truth registry for all Model Context Protocol based Servers running in your Organisation.

🧑‍💻 Developers use it to register & manage MCP servers and the tools they provide from a central place.

🤖 AI Agents use it to discover and consume all these tools from a single MCP Server.

MCPJungle is the only MCP Server your agents need to connect to!

1. Individuals using MCP Clients like Claude & Cursor that need to access multiple MCP servers for tools.
2. Devs building AI Agents that need to access MCP servers with built-in security and Access Control.
3. Organisations wanting to track all their MCP servers from one centralized place. Hosted in their own datacenter 🔒

MPCJungle is shipped as a stand-alone binary.

You can either download it from the Releases Page or use Homebrew to install it:

$ brew install mcpjungle/mcpjungle/mcpjungle

Verify your installation by running

$ mcpjungle version

MCPJungle has a Client-Server architecture and the binary lets you run both a Server and a Client.

For running the MCPJungle server locally, docker compose is the recommended way:

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

Otherwise, you can run the server directly using the binary:

$ mcpjungle start

This starts the main registry server responsible for managing all MCP servers. It is accessible on port 8080 by default.

The server also exposes its own MCP server at /mcp for AI Agents to discover and call Tools provided by the registered MCP Servers.

It relies on a database and by default, creates a SQLite DB in the current working directory. Alternatively, you can supply a DSN for a Postgresql database to the server:

$ export DATABASE_URL=postgres://admin:root@localhost:5432/mcpjungle_db
$ mcpjungle start

If you use docker-compose, the DB is automatically created and managed for you.

Once the server is up, you can use the CLI to interact with it.

Let's say you're already running a MCP server locally at https://127.0.0.1:8000/mcp which provides basic math tools like add, subtract, etc.

You can register this MCP server with MCPJungle:

$ mcpjungle register --name calculator --description "Provides some basic math tools" --url https://127.0.0.1:8000/mcp

If you used docker-compose to run the server, and you're not on Linux, you will have to use host.docker.internal instead of your local loopback address.

$ mcpjungle register --name calculator --description "Provides some basic math tools" --url https://host.docker.internal:8000/mcp

The registry will now start tracking this MCP server and load its tools.

Note: MCPJungle currently only supports MCP Servers using the Streamable HTTP Transport.

All tools provided by this server are now accessible via MCPJungle:

$ mcpjungle list tools
# Check tool usage
$ mcpjungle usage calculator/multiply
# Call a tool
$ mcpjungle invoke calculator/multiply --input '{"a": 100, "b": 50}'

Finally, you can remove a MCP server from the registry:

$ mcpjungle deregister calculator

After running this, the registry will stop tracking this server and its tools will no longer be available to use.

Use the following configuration in Cursor to connect to MCPJungle:

{
  "mcpServers": {
    "mcpjungle": {
      "url": "https://localhost:8080/mcp"
    }
  }
}

(Assuming that MCPJungle is running on localhost:8080)

MCPJungle currently supports authentication if your MCP Server accepts static tokens for auth.

This is useful when using SaaS-provided MCP Servers like HuggingFace, Stripe, etc. which require your API token for authentication.

You can supply your token while registering the MCP server:

# If you specify the `--bearer-token` flag, MCPJungle will add the `Authorization: Bearer <token>` header to all requests made to this MCP server.
$ mcpjungle register --name huggingface --description "HuggingFace MCP Server" --url https://huggingface.co/mcp --bearer-token <your-hf-api-token>

Support for Oauth flow is coming soon!

If you're running MCPJungle in your organisation, we recommend running the Server in the production mode:

# enable enterprise features by running in production mode
$ mcpjungle start --prod
# you can also specify the server mode as environment variable (valid values are `development` and `production`)
$ export SERVER_MODE=production
$ mcpjungle start
# this also works when running the server via docker-compose
$ SERVER_MODE=production docker-compose up

By default, mcpjungle server runs in development mode which is ideal for individuals running it locally.

In Production mode, the server enforces stricter security policies and will provide additional features like Authentication, ACLs, observability and more.

After starting the server in production mode, you must initialize it by running the following command on your client machine:

$ mcpjungle init-server

This will create an admin user in the server and store its API access token in your home directory (~/.mcpjungle.conf).

You can then use the mcpjungle cli to make authenticated requests to the server.

In development mode, all MCP clients have full access to all the MCP servers registered in MCPJungle Proxy.

production mode lets you control which MCP clients can access which MCP servers.

Suppose you have registered 2 MCP servers calculator and github in MCPJungle in production mode.

By default, no MCP client can access these servers. You must create an MCP Client in mcpjungle and explicitly allow it to access the MCP servers.

# Create a new MCP client for your Cursor IDE to use. It can access the calculator and github MCP servers
$ mcpjungle create mcp-client cursor-local --allow "calculator, github"
MCP client 'cursor-local' created successfully!
Servers accessible: calculator,github
Access token: 1YHf2LwE1LXtp5lW_vM-gmdYHlPHdqwnILitBhXE4Aw
Send this token in the `Authorization: Bearer {token}` HTTP header.

Mcpjungle creates an access token for your client. Configure your client or agent to send this token in the Authorization header when making requests to the mcpjungle proxy.

For example, you can add the following configuration in Cursor to connect to MCPJungle:

{
  "mcpServers": {
    "mcpjungle": {
      "url": "https://localhost:8080/mcp",
      "headers": {
        "Authorization": "Bearer 1YHf2LwE1LXtp5lW_vM-gmdYHlPHdqwnILitBhXE4Aw"
      }
    }
  }
}

A client that has access to a particular server this way can view and call all the tools provided by that server.

If you're interested in contributing to MCPJungle, see Developer Docs.