ni-c/mcp-hub

Overview

Serves multiple stdio MCP servers from a single container. Provides path routing, hub meta-tools, and authentication via OAuth 2.1 or API tokens for clients like ChatGPT, Claude, and Cursor.

Best for

Best for
Developers who want to expose multiple MCP servers through a single authenticated endpoint.

Use cases

• Run multiple MCP servers behind one endpoint
• Route client requests by path to specific MCP servers
• Secure access with OAuth 2.1 or API tokens for AI clients

How to use

Install

npx @ni-c/mcp-hub

Tools exposed

• EXTERNAL_URL
• PASSWORD_HASH
• TRUSTED_PROXIES
• RESOURCE_BOUND_TOKENS
• DEFAULT_RESOURCE
• MCP_BODY_LIMIT
• MCP_REQUESTS_PER_MINUTE
• MCP_MAX_CONCURRENT_REQUESTS
• MCP_MAX_CONCURRENT_STREAMS
• HTTP_HEADERS_TIMEOUT_MS
• HTTP_REQUEST_TIMEOUT_MS
• CONFIG_PATH
• DATA_PATH
• LOG_FILE
• CLIENT_REGISTRATION
• CIMD_ALLOWED_ORIGINS
• CIMD_ALLOW_PRIVATE_ADDRESSES
• DCR_MAX_CLIENTS
• DCR_PENDING_TTL_HOURS
• DCR_INACTIVE_DAYS

Clients listed in this record (not verified here)

Claude Desktop, Claude Code, Cursor, ChatGPT

Example client config

{
  "mcpServers": {
    "paperless": {
      "command": "paperless-mcp",
      "args": [],
      "env": {
        "PAPERLESS_API_TOKEN": "${PAPERLESS_API_TOKEN}"
      }
    },
    "homeassistant": {
      "type": "http",
      "url": "http://homeassistant:8123/api/mcp",
      "headers": {
        "Authorization": "Bearer ${HA_TOKEN}"
      }
    },
    "private-thing": {
      "command": "some-mcp",
      "args": [],
      "hub": false
    },
    "paperless-readonly": {
      "command": "paperless-mcp",
      "allowTools": [
        "search_*",
        "get_document"
      ],
      "denyTools": [
        "delete_document"
      ]
    },
    "untrusted": {
      "type": "docker",
      "image": "ghcr.io/example/untrusted-mcp@sha256:0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef",
      "network": "none",
      "memory": "256m"
    }
  }
}

Notes