# mcp-hub

> mcp-hub is an open-source MCP server for developer tools. Serve many stdio MCP servers from one container over HTTPS with OAuth 2.1. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** self-hosted, CLI, Linux
- **Website:** https://mcp-hub.ni-c.de
- **Repository:** https://github.com/ni-c/mcp-hub
- **MCP Registry name:** io.github.ni-c/mcp-hub
- **Categories:** developer tools
- **Listing updated:** 2026-11-14

## About

mcp-hub is a gateway for people who run several local MCP servers and want to reach them from clients that cannot start a process, such as ChatGPT connectors, Claude on the web, Le Chat, Cursor and LibreChat. One container takes the place of a separate auth proxy per server. The config file is the same mcpServers format Claude Code uses, so existing entries copy over, and each server gets its own endpoint at /name/mcp.

A /hub aggregate endpoint exposes every server through six meta-tools, so the model holds six schemas instead of every tool of every server. Servers start when used and go to sleep after 60 idle minutes by default, answering tool lists from a stored snapshot. A server or individual tools can be marked locked, so a model that calls them gets an unlock link instead of a result, and the person unlocks them with a password and an authenticator code.

It answers both MCP revisions, 2026-07-28 and 2025-11-25, on every endpoint, passes elicitation and change notifications through, and offers a stdio mode for clients that can only launch local processes. Login is a single password, with optional TOTP, plus long-lived API tokens for clients without OAuth.

## Features

- **Claude Code config format:** Reads the same mcpServers file, with stdio, http and sse upstreams.
- **Per-server endpoints:** Gives each server a Streamable HTTP path at /name/mcp.
- **Aggregate meta-tools:** One connector reaches every server through six meta-tools.
- **Tool filtering:** allowTools and denyTools hide tools and refuse calls to them.
- **Locked servers:** Dangerous servers or tools need a password and authenticator code to unlock.
- **Sleep on idle:** Servers start on demand and sleep after 60 idle minutes by default.

## Good for

- Reach home-lab stdio servers from ChatGPT or Claude on the web
- Replace one auth-proxy container per server
- Keep a shell or mailbox server locked until you approve
- Cut tool schema size in the model's context
- Give API-only clients a token to reach local servers

## Install

### Claude Code (Terminal)

```sh
claude mcp add mcp-hub -- npx -y @ni-c/mcp-hub
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "mcp-hub": {
      "command": "npx",
      "args": [
        "-y",
        "@ni-c/mcp-hub"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "mcp-hub": {
      "command": "npx",
      "args": [
        "-y",
        "@ni-c/mcp-hub"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "mcp-hub": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@ni-c/mcp-hub"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "mcp-hub": {
      "command": "npx",
      "args": [
        "-y",
        "@ni-c/mcp-hub"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "mcp-hub": {
      "command": "npx",
      "args": [
        "-y",
        "@ni-c/mcp-hub"
      ]
    }
  }
}
```

## Tools

- `list_servers`: Lists the servers behind the hub.
- `list_tools`: Lists the tools of a server.
- `get_tool_schema`: Returns the schema of one tool.
- `call_tool`: Calls a tool on a server.
- `wake_server`: Starts a sleeping server.
- `sleep_server`: Puts a server to sleep.

## FAQ

### How is it installed?

Through the npm package @ni-c/mcp-hub for stdio use, or the ghcr.io/ni-c/mcp-hub container image for the HTTPS gateway.

### What does the container need to start?

EXTERNAL_URL and PASSWORD_HASH are required, the latter a bcrypt hash of the login password.

### What are the six meta-tools?

list_servers, list_tools, get_tool_schema, call_tool, wake_server and sleep_server.

### Can it run without HTTP?

Yes. mcp-hub --stdio serves the same aggregate over stdin/stdout, with no TLS or login, for clients like Claude Desktop and Codex.

### Is mcp-hub free?

Yes. mcp-hub is open source, so you can use and self-host it for free.

### How do I add mcp-hub to Claude Code?

Run this command in your terminal: claude mcp add mcp-hub -- npx -y @ni-c/mcp-hub

### What are the best alternatives to mcp-hub?

The closest alternatives to mcp-hub are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/mcp-hub
