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 "Install 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 โญ
This server cannot be installed
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.