mcp-hub MCP Server

io.github.ni-c/mcp-hub

Repository Registry

What is the mcp-hub MCP server?

Many stdio MCP servers from one container, published over HTTPS with OAuth 2.1 for any MCP client

How to install mcp-hub

Copy-paste configuration for popular MCP clients.

transport: stdio

Config generated by PluginBench — verify against the source before use.

Environment / auth

CONFIG_PATH
Path to the mcp.json listing the servers to expose, in Claude Code's mcpServers format (default mcp.json in the working directory)
IDLE_TIMEOUT_MINUTES
Minutes of inactivity before a server is put to sleep; 0 starts every server at launch and keeps it running (default 60)
TOOL_CACHE_PATH
Tool snapshots of sleeping servers (default .mcp-hub/tool-cache.json beside the config)
LOG_FILE
Mirror the hub's log lines into this file; stdout carries the protocol, so logging goes to stderr otherwise
EXTERNAL_URL
required
Public base URL exactly as clients see it, e.g. https://mcp.example.net (no path)
PASSWORD_HASH
required
secret
bcrypt hash of the OAuth login password (htpasswd -bnBC 10 "" 'pw' | tr -d ':\n')
TRUSTED_PROXIES
Comma-separated IPs/CIDRs of the reverse proxy allowed to set X-Forwarded-* headers
CLIENT_REGISTRATION
Which mechanisms a client may use to obtain a client_id: cimd (Client ID Metadata Documents), dcr (RFC 7591 dynamic registration), or both
CIMD_ALLOWED_ORIGINS
Comma-separated https origins whose client ID metadata documents are accepted, e.g. https://chatgpt.com; unset admits every https origin
PORT
Listen port inside the container

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "mcp-hub": {
      "command": "npx",
      "args": [
        "-y",
        "@ni-c/mcp-hub",
        "--stdio"
      ],
      "env": {
        "CONFIG_PATH": "<YOUR_CONFIG_PATH>",
        "IDLE_TIMEOUT_MINUTES": "<YOUR_IDLE_TIMEOUT_MINUTES>",
        "TOOL_CACHE_PATH": "<YOUR_TOOL_CACHE_PATH>",
        "LOG_FILE": "<YOUR_LOG_FILE>",
        "EXTERNAL_URL": "<YOUR_EXTERNAL_URL>",
        "PASSWORD_HASH": "<YOUR_PASSWORD_HASH>",
        "TRUSTED_PROXIES": "<YOUR_TRUSTED_PROXIES>",
        "CLIENT_REGISTRATION": "<YOUR_CLIENT_REGISTRATION>",
        "CIMD_ALLOWED_ORIGINS": "<YOUR_CIMD_ALLOWED_ORIGINS>",
        "PORT": "<YOUR_PORT>"
      }
    }
  }
}