MCPHub
Acts as a unified gateway for the GitHub MCP server, allowing AI clients to interact with GitHub repositories, issues, and environment variables through a single managed endpoint.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@MCPHubshow the status and available tools for all my connected servers"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
π± MCPHub
One gateway to rule them all
A unified gateway and dashboard for managing multiple MCP (Model Context Protocol) servers. Think "Docker Compose + Dashboard" for MCP servers.
Quick Start Β· Features Β· Config Reference Β· Contributing
π© Why MCPHub?
If you work with AI tools in 2026, you probably have multiple MCP servers β filesystem, GitHub, databases, APIs. Managing them is painful:
β Scattered configs β every AI client needs its own MCP server list
β No visibility β which servers are running? What tools are available?
β No single endpoint β each client connects to each server separately
β Restart hell β add a server = restart everything
MCPHub fixes all of this:
β One YAML file to define all your MCP servers
β One gateway endpoint that routes to the right server
β Beautiful dashboard showing status, tools, and stats
β Hot reload β edit config, servers update instantly
ποΈ Architecture
βββββββββββββββββββββββββββββββββββββββββββββββββββ
β AI Clients β
β (Claude, Cursor, Copilot, etc.) β
ββββββββββββββββββββ¬βββββββββββββββββββββββββββββββ
β MCP Protocol (stdio)
βΌ
βββββββββββββββββββββββββββββββββββββββββββββββββββ
β π± MCPHub Gateway β
β β
β ββββββββββββ ββββββββββββ βββββββββββββββββ β
β β Registry β β Router β β Health Check β β
β ββββββββββββ ββββββββββββ βββββββββββββββββ β
β β
β ββββββββββββββββββββββββββββββββββββββββββββ β
β β π Web Dashboard (:3000) β β
β ββββββββββββββββββββββββββββββββββββββββββββ β
ββββββββ¬βββββββββββββββ¬βββββββββββββββ¬βββββββββββββ
β β β
βΌ βΌ βΌ
ββββββββββββββ ββββββββββββββ ββββββββββββββ
β filesystem β β github β β postgres β
β server β β server β β server β
ββββββββββββββ ββββββββββββββ ββββββββββββββπ Quick Start
1. Install
npm install -g mcphub2. Create mcphub.yaml
mcphub:
port: 3000
servers:
- name: filesystem
command: npx
args: ["-y", "@modelcontextprotocol/server-filesystem", "/home/user"]
- name: github
command: npx
args: ["-y", "@modelcontextprotocol/server-github"]
env:
GITHUB_TOKEN: "${GITHUB_TOKEN}"3. Run
mcphubOpen http://localhost:3000 to see the dashboard π
β¨ Features
Feature | Description |
π± Unified Gateway | Single MCP endpoint that routes to all downstream servers |
π One Config | Define all MCP servers in one |
π Web Dashboard | Beautiful dark-themed UI showing servers, tools, and stats |
π Hot Reload | Edit config β servers update automatically, no restart needed |
π Tool Discovery | Auto-discovers all tools from all connected servers |
π Health Checks | Periodic health monitoring of all downstream servers |
π Usage Stats | Request counts and error tracking per server |
π Env Variables | Reference |
π Config Reference
mcphub:
port: 3000 # Dashboard port (default: 3000)
log_level: info # debug | info | warn | error
servers:
- name: my-server # Unique server name (required)
command: npx # Command to start the server (required)
args: ["-y", "pkg"] # Command arguments (optional)
enabled: true # Enable/disable without removing (optional)
env: # Environment variables (optional)
KEY: "value"
SECRET: "${FROM_ENV}" # Reference host env varsEnvironment Variable Substitution
Use ${VAR_NAME} in any string value to reference the host environment:
env:
GITHUB_TOKEN: "${GITHUB_TOKEN}" # From host env
DATABASE_URL: "${DATABASE_URL}"π§ Using with AI Clients
Configure your AI client to connect to MCPHub instead of individual servers:
{
"mcpServers": {
"mcphub": {
"command": "mcphub",
"args": ["/path/to/mcphub.yaml"]
}
}
}All tools from all configured servers are now available through this single connection.
π€ Contributing
Contributions are welcome! Here's how:
Fork the repo
Create your feature branch:
git checkout -b feat/amazing-featureCommit:
git commit -m 'Add amazing feature'Push:
git push origin feat/amazing-featureOpen a Pull Request
Development
git clone https://github.com/NeuZhou/mcphub.git
cd mcphub
npm install
npm run devπ License
MIT Β© Kang Zhou
π± One gateway to rule them all π±
If MCPHub helps you, consider giving it a β
Related MCP Connectors
Unified gateway hosting 5 Hive Civilization MCP servers (evaluator, trade, depin, compute-gridβ¦
Zero-setup MCP gateway securely connecting AI to your tools with authentication and workflows
Unified gateway exposing 150+ tools across all NexGenData MCP servers via one endpoint.
MCP server for AI agents to plan, verify, and deploy Cloudflare-native apps.