MCPHub: The Unified Hub for Model Context Protocol (MCP) Servers

@samanhappy

About MCPHub: The Unified Hub for Model Context Protocol (MCP) Servers

A unified hub for centrally managing and dynamically orchestrating multiple MCP servers/APIs into separate endpoints with flexible routing strategies.

#mcp #mcp-server #mcp-hub #mcp-router

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "mcphub": {
      "command": "docker",
      "args": [
        "run",
        "-p",
        "3000:3000",
        "-v",
        "./mcp_settings.json:/app/mcp_settings.json",
        "-v",
        "./data:/app/data",
        "samanhappy/mcphub"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is MCPHub?

MCPHub is a unified hub that manages and scales multiple MCP (Model Context Protocol) servers by organizing them into flexible Streamable HTTP (SSE) endpoints, supporting access to all servers, individual servers, or logical server groups.

How to use MCPHub?

Create a mcp_settings.json file with your MCP server definitions, deploy via Docker with a single docker run command, and connect AI clients (Claude Desktop, Cursor, etc.) to endpoints like http://localhost:3000/mcp. Manage servers from a web dashboard or from the terminal using the included CLI.

Key features of MCPHub

Centralized management via a unified dashboard
Flexible routing to all servers, groups, or individual servers
Granular group visibility for Tools, Prompts, and Resources
AI-powered tool discovery using vector semantic search
Hot-swappable configuration without downtime
OAuth 2.0 support in both client and server modes
Docker-ready deployment with two image variants

Use cases of MCPHub

Run and monitor multiple MCP servers from a single dashboard
Expose server groups with tailored tool visibility to different AI clients
Deploy a production hub with PostgreSQL database and OAuth authentication
Discover and call tools from a terminal using the built-in CLI

FAQ from MCPHub

How do I deploy MCPHub?

Run docker run -p 3000:3000 -v ./mcp_settings.json:/app/mcp_settings.json -v ./data:/app/data samanhappy/mcphub. Two image variants are available: latest (includes Node.js, Python, uv/uvx, Git) and latest-full (adds Rust toolchain, Docker Engine, and Playwright browsers).

What storage options does MCPHub support?

By default MCPHub uses a file-based mcp_settings.json. For production environments, it supports Database Mode with PostgreSQL using TypeORM and pgvector for Smart Routing.

Can I manage MCPHub from the terminal?

Yes. The mcphub binary doubles as a CLI for the running hub, supporting commands like mcphub servers list, mcphub servers add, mcphub tools list, and mcphub call. No extra install is needed.

How do I secure MCPHub endpoints?

MCP endpoints require authentication by default. You can set an admin password via the ADMIN_PASSWORD environment variable, use OAuth 2.0, or enable bearer key authentication. Unauthenticated MCP access can be allowed by disabling bearer authentication in the Keys section.

Frequently asked questions

How do I deploy MCPHub?

Run `docker run -p 3000:3000 -v ./mcp_settings.json:/app/mcp_settings.json -v ./data:/app/data samanhappy/mcphub`. Two image variants are available: `latest` (includes Node.js, Python, uv/uvx, Git) and `latest-full` (adds Rust toolchain, Docker Engine, and Playwright browsers).

What storage options does MCPHub support?

By default MCPHub uses a file-based `mcp_settings.json`. For production environments, it supports Database Mode with PostgreSQL using TypeORM and pgvector for Smart Routing.

Can I manage MCPHub from the terminal?

Yes. The `mcphub` binary doubles as a CLI for the running hub, supporting commands like `mcphub servers list`, `mcphub servers add`, `mcphub tools list`, and `mcphub call`. No extra install is needed.

How do I secure MCPHub endpoints?

MCP endpoints require authentication by default. You can set an admin password via the `ADMIN_PASSWORD` environment variable, use OAuth 2.0, or enable bearer key authentication. Unauthenticated MCP access can be allowed by disabling bearer authentication in the Keys section.

Comments

Basic information

More Other MCP servers

Inbox Zero AI MCP

elie222

The world's best AI personal assistant for email. Open source app to help you reach inbox zero fast.

11.6K

EverArt

modelcontextprotocol

Model Context Protocol Servers

88.1K

MaxKB

1Panel-dev

🔥 MaxKB is an open-source platform for building enterprise-grade agents. 强大易用的开源企业级智能体平台。

22.0K

Peekaboo MCP – lightning-fast macOS screenshots for AI agents

steipete

Peekaboo is a macOS CLI & optional MCP server that enables AI agents to capture screenshots of applications, or the entire system, with optional visual question answering through local or remote AI models.

4.8K

Nginx UI

0xJacky

Yet another WebUI for Nginx

11.3K