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

Englisch |中文版

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

🚀 Funktionen

• Erweiterte MCP-Server-Unterstützung : Integrieren Sie jeden MCP-Server nahtlos mit minimaler Konfiguration.

• Zentralisiertes Dashboard : Überwachen Sie Status und Leistungsmetriken in Echtzeit über eine elegante Web-Benutzeroberfläche.

• Flexible Protokollhandhabung : Vollständige Kompatibilität mit den Protokollen stdio und SSE MCP.

• Hot-Swap-fähige Konfiguration : Fügen Sie MCP-Server im laufenden Betrieb hinzu, entfernen oder aktualisieren Sie sie – keine Ausfallzeit erforderlich.

• Gruppenbasierte Zugriffskontrolle : Organisieren Sie Server in anpassbaren Gruppen für eine optimierte Berechtigungsverwaltung.

• Sichere Authentifizierung : Integrierte Benutzerverwaltung mit rollenbasiertem Zugriff, unterstützt durch JWT und bcrypt.

• Docker-Ready : Sofortige Bereitstellung mit unserem Container-Setup.

Related MCP server: GitHub Repos Manager MCP Server

🔧 Schnellstart

Optionale Konfiguration

Erstellen Sie eine mcp_settings.json -Datei, um Ihre Servereinstellungen anzupassen:

{
  "mcpServers": {
    "amap": {
      "command": "npx",
      "args": ["-y", "@amap/amap-maps-mcp-server"],
      "env": {
        "AMAP_MAPS_API_KEY": "your-api-key"
      }
    },
    "playwright": {
      "command": "npx",
      "args": ["@playwright/mcp@latest", "--headless"]
    },
    "fetch": {
      "command": "uvx",
      "args": ["mcp-server-fetch"]
    },
    "slack": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-slack"],
      "env": {
        "SLACK_BOT_TOKEN": "your-bot-token",
        "SLACK_TEAM_ID": "your-team-id"
      }
    }
  }
}

Docker-Bereitstellung

Empfohlen : Mounten Sie Ihre benutzerdefinierte Konfiguration:

docker run -p 3000:3000 -v $(pwd)/mcp_settings.json:/app/mcp_settings.json samanhappy/mcphub

oder mit den Standardeinstellungen ausführen:

docker run -p 3000:3000 samanhappy/mcphub

Zugriff auf das Dashboard

Öffnen Sie http://localhost:3000 und melden Sie sich mit Ihren Anmeldeinformationen an.

Hinweis : Die Standardanmeldeinformationen lauten admin / admin123 .

Dashboard-Übersicht :

• Live-Status aller MCP-Server

• Server aktivieren/deaktivieren oder neu konfigurieren

• Gruppenverwaltung zum Organisieren von Servern

• Benutzerverwaltung zur Zugriffskontrolle

Streambarer HTTP-Endpunkt

Die Unterstützung für das Streaming von HTTP-Endpunkten variiert derzeit je nach KI-Client. Bei Problemen können Sie den SSE-Endpunkt verwenden oder auf zukünftige Updates warten.

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

http://localhost:3000/mcp

Dieser Endpunkt bietet eine einheitliche, streambare HTTP-Schnittstelle für alle Ihre MCP-Server. Er ermöglicht Ihnen:

• Senden Sie Anfragen an jeden konfigurierten MCP-Server

• Erhalten Sie Antworten in Echtzeit

• Einfache Integration mit verschiedenen KI-Clients und -Tools

• Verwenden Sie denselben Endpunkt für alle Server und vereinfachen Sie so Ihren Integrationsprozess

Gruppenspezifische Endpunkte (empfohlen) :

Für den gezielten Zugriff auf bestimmte Servergruppen verwenden Sie den gruppenbasierten HTTP-Endpunkt:

http://localhost:3000/mcp/{group}

Wobei {group} die ID oder der Name der Gruppe ist, die Sie im Dashboard erstellt haben. Dies ermöglicht Ihnen:

• Stellen Sie eine Verbindung zu einer bestimmten Teilmenge von MCP-Servern her, die nach Anwendungsfall organisiert sind

• Isolieren Sie verschiedene KI-Tools, um nur auf relevante Server zuzugreifen

• Implementieren Sie eine detailliertere Zugriffskontrolle für verschiedene Umgebungen oder Teams

Serverspezifische Endpunkte : Für den direkten Zugriff auf einzelne Server verwenden Sie den serverspezifischen HTTP-Endpunkt:

http://localhost:3000/mcp/{server}

Dabei ist {server} der Name des Servers, mit dem Sie eine Verbindung herstellen möchten. Dadurch können Sie direkt auf einen bestimmten MCP-Server zugreifen.

Hinweis : Wenn Servername und Gruppenname identisch sind, hat der Gruppenname Vorrang.

SSE-Endpunkt (in Zukunft veraltet)

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

http://localhost:3000/sse

Für den gezielten Zugriff auf bestimmte Servergruppen verwenden Sie den gruppenbasierten SSE-Endpunkt:

http://localhost:3000/sse/{group}

Für den direkten Zugriff auf einzelne Server verwenden Sie den serverspezifischen SSE-Endpunkt:

http://localhost:3000/sse/{server}

🧑‍💻 Lokale Entwicklung

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

Dadurch werden sowohl das Frontend als auch das Backend im Entwicklungsmodus mit Hot-Reloading gestartet.

Windows-Benutzer müssen den Backend-Server und das Frontend möglicherweise separat starten: pnpm backend:dev , pnpm frontend:dev .

🛠️ Häufige Probleme

Verwenden von Nginx als Reverse-Proxy

Wenn Sie Nginx zum Reverse-Proxy von MCPHub verwenden, achten Sie darauf, die folgende Konfiguration in Ihrem Nginx-Setup hinzuzufügen:

proxy_buffering off

🔍Tech-Stack

• Backend : Node.js, Express, TypeScript

• Frontend : React, Vite, Tailwind CSS

• Authentifizierung : JWT und bcrypt

• Protokoll : Model Context Protocol SDK

👥 Beitragen

Beiträge jeglicher Art sind willkommen!

• Neue Funktionen und Optimierungen

• Verbesserungen der Dokumentation

• Fehlerberichte und Fehlerbehebungen

• Übersetzungen und Vorschläge

Willkommen in unserer Discord-Community für Diskussionen und Support.

❤️ Sponsor

Wenn Ihnen dieses Projekt gefällt, können Sie vielleicht Folgendes in Betracht ziehen:

🌟 Sternengeschichte

📄 Lizenz

Lizenziert unter der Apache 2.0-Lizenz .