MCPHub

v1.0.0Developer Toolsstable

MCPHub transforms scattered MCP servers into one unified platform. Connect your AI agent to a single endpoint and instantly unlock unlimited tools—no more juggling dozens of server configs. Hot-swap plugins without restart, proxy existing servers in

mcpmcp-gatewaymcp-hubmcp-routermcp-server
Share:
2,095
Stars
0
Downloads
0
Weekly
0/5

What is MCPHub?

MCPHub is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to mcphub transforms scattered mcp servers into one unified platform. connect your ai agent to a single endpoint and instantly unlock unlimited tools—no more juggling dozens of server configs. hot-swap p...

MCPHub transforms scattered MCP servers into one unified platform. Connect your AI agent to a single endpoint and instantly unlock unlimited tools—no more juggling dozens of server configs. Hot-swap plugins without restart, proxy existing servers in

This server falls under the Developer Tools category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • MCPHub transforms scattered MCP servers into one unified pla

Use Cases

Unify multiple MCP servers into a single endpoint.
Hot-swap MCP plugins without restarting the service.
samanhappy

Maintainer

LicenseApache-2.0
Languagetypescript
Versionv1.0.0
UpdatedMay 21, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

Manual Installation

npx mcphub

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use MCPHub

MCPHub is a unified MCP gateway that aggregates multiple MCP servers behind a single endpoint, so AI agents only need one connection to access all your tools. It features a web dashboard for managing servers, hot-swap plugin loading without restarts, an AI-powered smart tool discovery endpoint, and a built-in CLI for scripting. Teams use it to eliminate the configuration sprawl of managing dozens of individual MCP server entries in their client configs and to enable dynamic tool routing across agents.

Prerequisites

  • Docker installed (recommended) or Node.js 18+ with pnpm for local development
  • An mcp_settings.json file listing the MCP servers you want to aggregate
  • An MCP client such as Claude Desktop, Cursor, or any agent supporting SSE/HTTP MCP transport
  • Port 3000 available on the host
1

Create an mcp_settings.json configuration file

Define the MCP servers you want MCPHub to aggregate. Each entry follows the standard MCP server spec with command, args, and optional env.

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

Run MCPHub with Docker

Start the MCPHub container, mounting your settings file. The dashboard will be available at http://localhost:3000.

docker run -p 3000:3000 \
  -v ./mcp_settings.json:/app/mcp_settings.json \
  -v ./data:/app/data \
  samanhappy/mcphub
3

Log in to the dashboard

Open http://localhost:3000 in your browser. The default login username is 'admin' and the password is either the value you set via the ADMIN_PASSWORD environment variable or a random value printed in the container logs on first startup.

4

Connect your MCP client to MCPHub

Point your AI agent to one of the MCPHub endpoints. Use the aggregate endpoint to expose all server tools, or the smart endpoint for AI-powered tool discovery.

# All tools aggregated:
http://localhost:3000/mcp

# AI-powered smart tool discovery:
http://localhost:3000/mcp/$smart
5

Configure Claude Desktop

Add MCPHub as a remote server in claude_desktop_config.json so Claude can access all aggregated tools through a single connection.

{
  "mcpServers": {
    "mcphub": {
      "url": "http://localhost:3000/mcp",
      "transport": "http"
    }
  }
}

MCPHub Examples

Client configuration

Claude Desktop config pointing to the MCPHub aggregate endpoint.

{
  "mcpServers": {
    "mcphub": {
      "url": "http://localhost:3000/mcp",
      "transport": "http"
    }
  }
}

Prompts to try

Example prompts once MCPHub is running with aggregated servers.

- "List all the tools available to you right now."
- "Fetch the content of https://example.com using the fetch tool."
- "What is the current time in Tokyo?"
- "Add a new MCP server to the hub without restarting anything."

Troubleshooting MCPHub

Dashboard login fails with unknown password

If ADMIN_PASSWORD was not set, MCPHub generates a random password on first start. Check the container logs with 'docker logs <container-id>' to find the generated password.

Tools from a registered server are not appearing

Verify the server entry in mcp_settings.json is correct and that the command (e.g., uvx) is accessible inside the container. Mount any additional binaries or check that they are installed in the Docker image.

MCP client gets connection refused on port 3000

Ensure the Docker container is running and the -p 3000:3000 port mapping is active. If using a firewall, allow inbound connections on port 3000 from localhost.

Frequently Asked Questions about MCPHub

What is MCPHub?

MCPHub is a Model Context Protocol (MCP) server that mcphub transforms scattered mcp servers into one unified platform. connect your ai agent to a single endpoint and instantly unlock unlimited tools—no more juggling dozens of server configs. hot-swap plugins without restart, proxy existing servers in It connects AI assistants to external tools and data sources through a standardized interface.

How do I install MCPHub?

Follow the installation instructions on the MCPHub GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with MCPHub?

MCPHub works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is MCPHub free to use?

Yes, MCPHub is open source and available under the Apache-2.0 license. You can use it freely in both personal and commercial projects.

Browse More Developer Tools MCP Servers

Explore all developer tools servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Quick Config Preview

{ "mcpServers": { "mcphub": { "command": "npx", "args": ["-y", "mcphub"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use MCPHub?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides