mcp-hub
Many stdio MCP servers from one container, published over HTTPS with OAuth 2.1 for any MCP client
What this server provides
Many stdio MCP servers from one container, published over HTTPS with OAuth 2.1 for any MCP client
Packages
npxTransport stdio- CONFIG_PATHOptional
Path to the mcp.json listing the servers to expose, in Claude Code's mcpServers format (default mcp.json in the working directory)
Format: string - IDLE_TIMEOUT_MINUTESOptional
Minutes of inactivity before a server is put to sleep; 0 starts every server at launch and keeps it running (default 60)
Format: number · Default: 60 - TOOL_CACHE_PATHOptional
Tool snapshots of sleeping servers (default .mcp-hub/tool-cache.json beside the config)
Format: string - LOG_FILEOptional
Mirror the hub's log lines into this file; stdout carries the protocol, so logging goes to stderr otherwise
Format: string
Not declaredTransport streamable-httphttp://localhost:{PORT}/hub- EXTERNAL_URLRequired
Public base URL exactly as clients see it, e.g. https://mcp.example.net (no path)
Format: string - PASSWORD_HASHRequired
bcrypt hash of the OAuth login password (htpasswd -bnBC 10 "" 'pw' | tr -d ':\n')
Format: string - TWO_FACTOROptional
Set to totp to ask for a one-time code from an authenticator app at every sign-in. Default off.
Format: string - TOTP_SECRETOptional
Base32 secret the authenticator app was set up with (mcp-hub-admin totp init). Read only when TWO_FACTOR is totp.
Format: string - TRUSTED_PROXIESOptional
Comma-separated IPs/CIDRs of the reverse proxy allowed to set X-Forwarded-* headers
Format: string - CLIENT_REGISTRATIONOptional
Which mechanisms a client may use to obtain a client_id: cimd (Client ID Metadata Documents), dcr (RFC 7591 dynamic registration), or both
Format: string · Default: cimd,dcr - CIMD_ALLOWED_ORIGINSOptional
Comma-separated https origins whose client ID metadata documents are accepted, e.g. https://chatgpt.com; unset admits every https origin
Format: string - PORTOptional
Listen port inside the container
Format: number · Default: 80