MCPHub

# MCPHub — Desktop App

English | Français | 中文版

MCPHub is a desktop application that aggregates multiple MCP (Model Context Protocol) servers behind a single, easy-to-manage hub. It bundles an Electron shell, a Node.js/Express backend, and a React dashboard — install it, add your MCP servers, and expose them to AI clients (Claude Desktop, Cursor, etc.) through simple HTTP/SSE endpoints.

✨ Features

• Centralized Management - Monitor and control all MCP servers from a unified dashboard

• Flexible Routing - Access all servers, specific groups, or individual servers via HTTP/SSE

• Granular Group Visibility - Control Tool, Prompt, and Resource visibility per server inside a group

• Per-Server Sharing - Keep servers private, share them with selected users, or make them public

• Smart Routing - AI-powered tool discovery using vector semantic search

• MCP Apps Proxy - Transparently forward interactive MCP Apps on single-server routes

• Tool Result Compression - Reduce large text tool outputs before they reach clients

• Hot-Swappable Config - Add, remove, or update servers without downtime

• OAuth 2.0 Support - Client and server modes for secure authentication

• System Tray - Quick access to the dashboard, logs, and quit from the tray icon

Related MCP server: MCPHub

📦 Download & Install

Download the latest Windows installer from the Releases page:

• MCPHub-<version>-setup.exe — NSIS installer (recommended)

Install steps:

1. Run the installer and follow the wizard (you can choose the install directory).

2. Launch MCPHub from the desktop or Start Menu shortcut.

3. The app starts the built-in server on port 3000 and opens the dashboard.

If your security software warns about the installer, add it to the whitelist — the app is unsigned (no code-signing certificate).

🚀 Quick Start

1. Log in with the default credentials: admin / admin123.

2. Go to Servers and add your MCP servers (e.g. npx -y time-mcp, uvx mcp-server-fetch), or edit mcp_settings.json in the app data folder.

3. Connect your AI clients:

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

Security note: MCP endpoints require authentication by default. To allow unauthenticated MCP access, disable Enable Bearer Authentication in the Keys section. Use only in trusted environments.

📚 Documentation

• 中文使用文档

• Developer docs (docs/)

• Report a bug / Request a feature

🧑‍💻 Local Development

git clone https://github.com/GW19ddd/MCPHub-desktop.git
cd MCPHub-desktop
pnpm install
pnpm dev

Local development uses admin / admin123 and stores its writable settings copy at data/mcp_settings.dev.json.

Windows users: start backend and frontend separately with pnpm backend:dev and pnpm frontend:dev.

Build the desktop app:

cd electron
pnpm install
pnpm build        # compile Electron main process
cd ..
npx electron-builder --config electron/electron-builder.yml

The installer is written to release/MCPHub-<version>-setup.exe.

🔍 Tech Stack

• Desktop shell: Electron

• Backend: Node.js, Express, TypeScript (ESM)

• Frontend: React, Vite, Tailwind CSS

• Storage: file-based mcp_settings.json by default; optional PostgreSQL (TypeORM + pgvector) for Smart Routing

• Auth: JWT + bcrypt; bearer keys; built-in OAuth 2.0 server (@node-oauth/oauth2-server)

• Protocol: Model Context Protocol SDK

📄 License

Licensed under the Apache 2.0 License.