MCPHub: The Unified Hub for Model Context Protocol (MCP) Servers
@samanhappy
A unified hub for centrally managing and dynamically orchestrating multiple MCP servers/APIs into separate endpoints with flexible routing strategies.
概要
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.
