HomeDevelopment › mcp-hub

mcp-hub

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

TypeScript Local macOSWindowsLinux
★ 2 stars Last pushed 2026-09-20 License: MIT

Topics: Aggregators

Connect

Review any command before running it. Package names and URLs come from the server's own registry entry.

Package (npm 0.11.3)

npx -y @ni-c/[email protected]

Or add to your MCP client config:

{
  "mcpServers": {
    "mcp-hub": {
      "command": "npx",
      "args": [
        "-y",
        "@ni-c/[email protected]"
      ],
      "env": {
        "CONFIG_PATH": "<YOUR_VALUE>",
        "IDLE_TIMEOUT_MINUTES": "<YOUR_VALUE>",
        "TOOL_CACHE_PATH": "<YOUR_VALUE>",
        "LOG_FILE": "<YOUR_VALUE>"
      }
    }
  }
}
  • 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

This server takes extra arguments — see its repository.

Package (oci)

Package: oci ghcr.io/ni-c/mcp-hub:0.11.3

  • 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

Related servers

Listed in punkpeye/awesome-mcp-servers (MIT)

Data from the Official MCP Registry