MCPHub: Das einheitliche Hub für Model Context Protocol (MCP)-Server

English | Français | 中文版

MCPHub erleichtert die Verwaltung und Skalierung mehrerer MCP-Server (Model Context Protocol), indem es sie in flexible Streamable-HTTP-Endpunkte (SSE) organisiert – mit Unterstützung für den Zugriff auf alle Server, einzelne Server oder logische Servergruppen.

🌐 Live-Demo & Dokumentation

• Dokumentation: docs.mcphub.app

• Demo-Umgebung: demo.mcphub.app

Related MCP server: MetaMCP

🚀 Funktionen

• Zentrale Verwaltung – Alle MCP-Server von einem einheitlichen Dashboard aus überwachen und steuern

• Flexibles Routing – Zugriff auf alle Server, bestimmte Gruppen oder einzelne Server über HTTP/SSE

• Granulare Gruppen-Sichtbarkeit – Sichtbarkeit von Tools, Prompts und Ressourcen für jeden Server in einer Gruppe unabhängig steuern

• Intelligentes Routing – KI-gestützte Tool-Erkennung mithilfe vektorbasierter semantischer Suche (Mehr erfahren)

• MCP-Apps-Proxy – Transparentes Weiterleiten interaktiver MCP-Apps auf Einzelserver-Routen (Mehr erfahren)

• Tool-Ergebnis-Komprimierung – Große Textausgaben von Tools vor dem Erreichen der Clients transparent reduzieren

• Hot-Swappable-Konfiguration – Server ohne Ausfallzeiten hinzufügen, entfernen oder aktualisieren

• OAuth-2.0-Unterstützung – Sowohl Client- als auch Servermodus für sichere Authentifizierung (Mehr erfahren)

• Social Login – Nahtlose GitHub- und Google-Anmeldung mit Better Auth-Integration (erfordert Datenbankmodus)

• Datenbankmodus – Konfiguration in PostgreSQL für Produktionsumgebungen speichern (Mehr erfahren)

• Docker-Ready – Sofortige Bereitstellung mit containerisierter Einrichtung

🔧 Schnellstart

Konfiguration

Erstellen Sie eine mcp_settings.json-Datei:

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

📖 Siehe Konfigurationsanleitung für alle Optionen einschließlich OAuth, Umgebungsvariablen und mehr.

Docker-Bereitstellung

# 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 (also mount ./data so credentials and state survive restarts)
docker run -p 3000:3000 -v ./data:/app/data samanhappy/mcphub

Unter samanhappy/mcphub werden zwei Image-Varianten veröffentlicht:

• latest – das Standard-Image. Enthält Node.js/pnpm, Python, uv/uvx, Git und Build-Tools. Deckt die meisten MCP-Server ab.

• latest-full – das erweiterte Image. Fügt die Rust-Toolchain (Cargo/rustc), Docker Engine und Playwright-Browser (Chrome + Firefox, nur amd64) hinzu. Verwenden Sie dies für Rust-basierte Server oder Container-in-Container-Workflows. Größerer Download.

Siehe Docker-Einrichtung für Build-Optionen und Docker-in-Docker-Konfiguration.

Dashboard aufrufen

Öffnen Sie http://localhost:3000 und melden Sie sich mit dem Benutzernamen admin an. Beim ersten Start wird ein zufälliges Passwort generiert und in den Server-Logs ausgegeben, sofern keine ADMIN_PASSWORD-Umgebungsvariable gesetzt ist. Sie können das Passwort auch vorab festlegen:

# Docker: set admin password via environment variable
docker run -p 3000:3000 -e ADMIN_PASSWORD=your-secure-password samanhappy/mcphub

Tipp: Ändern Sie das Admin-Passwort aus Sicherheitsgründen nach der ersten Anmeldung.

Headless-Modus: Setzen Sie DISABLE_WEB=true, um die Bereitstellung der gebündelten Dashboard-Oberfläche zu überspringen und MCPHub nur mit Backend/API und MCP-Endpunkten auszuführen. Dies ist nützlich, wenn Sie Server direkt über mcp_settings.json verwalten möchten.

KI-Clients verbinden

Verbinden Sie KI-Clients (Claude Desktop, Cursor usw.) über:

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

Sicherheitshinweis: MCP-Endpunkte erfordern standardmäßig eine Authentifizierung, um versehentliche Offenlegung zu verhindern. Um MCP-Zugriff ohne Authentifizierung zu ermöglichen, deaktivieren Sie die Einstellung Bearer-Authentifizierung aktivieren im Bereich „Schlüssel“. Authentifizierung überspringen betrifft nur die Dashboard-Anmeldung. Nur in vertrauenswürdigen Umgebungen verwenden.

📖 Siehe API-Referenz für detaillierte Endpunkt-Dokumentation.

Vom Terminal aus verwalten

Dieselbe mcphub-Binärdatei dient auch als CLI für das laufende Hub – keine zusätzliche Installation erforderlich.

mcphub login --url http://localhost:3000 --username admin
mcphub servers list
mcphub servers add fetch --type stdio --command uvx --arg mcp-server-fetch
mcphub tools list                              # discover what tools are available
mcphub tools get fetch_url                     # see required params + sample command
mcphub call fetch_url url=https://example.com --json
mcphub keys create --name ci --access-type all

Sie spricht auch die öffentliche Marktplatz-API (mcphub discover, mcphub install ...) an, sodass Serversuche und Ein-Befehl-Installation für jedes Hub mit aktivierter Discovery funktionieren.

📖 Siehe CLI-Anleitung für alle Unterbefehle, Profile und CI-Nutzung.

📚 Dokumentation

🧑💻 Lokale Entwicklung

git clone https://github.com/samanhappy/mcphub.git
cd mcphub
pnpm install
pnpm dev

Die lokale Entwicklung verwendet admin / admin123 und speichert ihre beschreibbare Einstellungskopie unter data/mcp_settings.dev.json, sodass die mcp_settings.json im Repository ohne Anmeldedaten bleibt.

Für Windows-Benutzer: Starten Sie Backend und Frontend getrennt: pnpm backend:dev, pnpm frontend:dev

📖 Siehe Entwicklungsanleitung für detaillierte Einrichtungsanweisungen.

🔍 Technologie-Stack

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

• Frontend: React, Vite, Tailwind CSS

• Speicherung: standardmäßig dateibasiert (mcp_settings.json); PostgreSQL über TypeORM mit pgvector für Intelligentes Routing

• Auth: JWT + bcrypt für lokale Konten; Bearer-Schlüssel; integrierter OAuth-2.0-Server (@node-oauth/oauth2-server); optional Better Auth für GitHub/Google-Anmeldung

• Protokoll: Model Context Protocol SDK

👥 Mitwirken

Beiträge sind willkommen! Besuchen Sie unsere Discord-Community für Diskussionen und Support.

❤️ Sponsor

🌟 Sternverlauf

📄 Lizenz

Lizenziert unter der Apache-2.0-Lizenz.