MCPHub is a unified management platform and orchestration hub for running multiple Model Context Protocol (MCP) servers. It aggregates individual MCP servers into flexible Streamable HTTP (SSE) endpoints, allowing you to access all servers, specific groups, or individual services through configurable routing strategies. Key capabilities of MCPHub include: - Centralized dashboard for monitoring and controlling multiple MCP servers from a single interface - Flexible endpoint routing that exposes all servers, server groups, or individual services via distinct HTTP/SSE URLs - AI-powered smart routing with vector semantic search for automatic tool discovery and selection - Hot-swappable configuration that enables adding, removing, or updating servers without downtime - OAuth 2.0 authentication support in both client and server modes, plus social login via GitHub and Google - Database-backed configuration with PostgreSQL support for production deployments or JSON-based file configuration - Docker-ready containerized deployment for instant setup and scaling

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

English | Français | 中文版

MCPHub makes it easy to manage and scale 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.

🌐 Live Demo & Docs

🚀 Features

🔧 Quick Start

Configuration

Create a mcp_settings.json file:

{
  "mcpServers": {
    "time": {
      "command": "npx",
      "args": ["-y", "time-mcp"]
    },
    "fetch": {
      "command": "uvx",
      "args": ["mcp-server-fetch"]
    }
  }
}

📖 See Configuration Guide for full options including OAuth, environment variables, and more.

Docker Deployment

# Run with custom config (recommended)
docker run -p 3000:3000 -v ./mcp_settings.json:/app/mcp_settings.json -v ./data:/app/data samanhappy/mcphub
Or run with default settings
docker run -p 3000:3000 samanhappy/mcphub

Access Dashboard

Open http://localhost:3000 and log in with default credentials: admin / admin123

Connect AI Clients

Connect AI clients (Claude Desktop, Cursor, etc.) via:

http://localhost:3000/mcp           # All servers
http://localhost:3000/mcp/{group}   # Specific group
http://localhost:3000/mcp/{server}  # Specific server
http://localhost:3000/mcp/$smart    # Smart routing
http://localhost:3000/mcp/$smart/{group}  # Smart routing within group

> Security note: MCP endpoints require authentication by default to prevent accidental exposure. To allow unauthenticated MCP access, disable Enable Bearer Authentication in the Keys section. Skip Authentication only affects dashboard login. Use these only in trusted environments.

📖 See API Reference for detailed endpoint documentation.

📚 Documentation

| Topic | Description | | ------------------------------------------------------------------------------ | --------------------------------- | | Quick Start | Get started in 5 minutes | | Configuration | MCP server configuration options | | Database Mode | PostgreSQL setup for production | | OAuth | OAuth 2.0 client and server setup | | Smart Routing | AI-powered tool discovery | | Docker Setup | Docker deployment guide |

🧑‍💻 Local Development

git clone https://github.com/samanhappy/mcphub.git
cd mcphub
pnpm install
pnpm dev

> For Windows users, start backend and frontend separately: pnpm backend:dev, pnpm frontend:dev

📖 See Development Guide for detailed setup instructions.

🔍 Tech Stack

👥 Contributing

Contributions welcome! See our Discord community for discussions and support.

❤️ Sponsor

[](https://ko-fi.com/samanhappy)

🌟 Star History

[](https://www.star-history.com/#samanhappy/mcphub&Date)

📄 License

Licensed under the Apache 2.0 License.