by samanhappy
A unified hub for centrally managing and dynamically orchestrating multiple MCP servers/APIs into separate endpoints with flexible routing strategies
# Add to your Claude Code skills
git clone https://github.com/samanhappy/mcphubMCPHub 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.

No comments yet. Be the first to share your thoughts!
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.
# 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
Open http://localhost:3000 and log in with username admin. On first launch, if no ADMIN_PASSWORD environment variable is set, a random password is generated and printed to the server logs. You can also pre-set the password:
# Docker: set admin password via environment variable
docker run -p 3000:3000 -e ADMIN_PASSWORD=your-secure-password samanhappy/mcphub
Tip: Change the admin password after first login for security.
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 only in trusted environments.
📖 See API Reference for detailed endpoint 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 |
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.
Contributions welcome! See our Discord community for discussions and support.
Licensed under the Apache 2.0 License.