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

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

@samanhappy

关于 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

基本信息

分类

其他

许可证

Apache-2.0

运行时

node

传输方式

stdio

发布者

samanhappy

配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

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

工具

未检测到工具

工具是从 README 中自动提取的。维护者可以在 ## Tools 标题下列出工具,即可填充这部分内容。

概览

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.