AI导哈

模块化协议服务器

一个支持多租户、插件机制的模块化协议服务器，具有自动发现功能和现代React前端界面。

  • by NinjaEde
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 ninjaede/mcp-server-dynamic-registry

使用说明

MCP Server Demo

Dieses Projekt demonstriert eine modulare, Multi-Tenant-fähige Architektur für das Model Context Protocol (MCP) mit Plug-and-Play-Mechanismus, Auto-Discovery und einer modernen React-UI. Die Kommunikation erfolgt über einen zentralen Orchestrator, der Anfragen an verschiedene MCP-Module verteilt.

Features

  • Multi-Tenant: Jeder Tenant kann eigene API-Keys und Modulzuordnungen haben.
  • Plug-and-Play: Neue MCP-Module können einfach hinzugefügt und dynamisch genutzt werden.
  • Auto-Discovery: Der Orchestrator erkennt verfügbare Module automatisch.
  • React-Frontend: Komfortable Verwaltung und Testen von Tenants und Modulen.
  • Docker-basiert: Alle Komponenten laufen als Container im selben Netzwerk.

Projektstruktur

mcp-server-demo/
│
├── orchestrator/         # Zentrale API, Discovery, Multi-Tenant-Logik
│   ├── main.py
│   ├── kunden.json       # Tenant-Konfiguration
│   └── ...
│
├── mcp_proalpha/         # Beispiel-MCP-Modul (ProAlpha)
│   └── main.py
├── mcp_hubspot/          # Beispiel-MCP-Modul (HubSpot)
│   └── main.py
├── mcp_docs/             # Beispiel-MCP-Modul (Docs)
│   └── main.py
│
├── frontend-react/       # React-UI für Tenant- und Modulverwaltung
│   └── src/App.tsx
│
├── docker-compose.yml    # Startet alle Services im gemeinsamen Netzwerk
└── README.md

Schnellstart

Voraussetzungen

  • Docker & Docker Compose
  • Node.js (nur für lokale Frontend-Entwicklung)

Starten aller Services

docker-compose up --build

Beispiel: Anfrage an den Orchestrator

curl -X POST http://localhost:8000/query \
  -H "Content-Type: application/json" \
  -H "X-API-Key: abc123" \
  -d '{"query": "Was ist der Status?"}'

Antwort:

{
  "kunde": "kunde1",
  "antworten": [
    "mcp_proalpha: Antwort von ProAlpha: Was ist der Status?",
    "mcp_hubspot: Antwort von HubSpot: Was ist der Status?"
  ]
}

Frontend-Funktionen

  • Tenants anlegen, auswählen und löschen
  • API-Key-Verwaltung pro Tenant
  • Module pro Tenant zuordnen
  • Anfragen an den Orchestrator senden und Antworten anzeigen

Eigene Module hinzufügen

  1. Neuen Ordner nach Vorbild von mcp_proalpha anlegen.
  2. FastAPI-Service mit /answer-Endpoint implementieren.
  3. In docker-compose.yml als neuen Service eintragen.
  4. Im Frontend oder in kunden.json dem gewünschten Tenant zuordnen.

MCP Architektur & Kommunikation

  • Die MCP-Module (z.B. mcp_proalpha, mcp_hubspot, mcp_docs) werden nicht als eigenständige HTTP-Services angesprochen, sondern vom Orchestrator als Subprozesse per MCP-Protokoll (stdio) gestartet und angesprochen.
  • Der Orchestrator nutzt die offizielle MCP Python-Clientbibliothek, um die Tools der Module dynamisch aufzurufen.
  • Damit dies funktioniert, müssen alle Python-Abhängigkeiten der Module auch im Orchestrator-Container installiert sein (siehe orchestrator/requirements.txt).
  • Die orchestrator-Query-API startet für jede Anfrage die jeweiligen Module als Subprozess und ruft das Tool (z.B. answer) auf.
  • Die Discovery prüft weiterhin, ob die Module im Dateisystem vorhanden sind.

Wichtige Hinweise für Docker

  • Im orchestrator-Service wird das gesamte Projektverzeichnis (.:/app) gemountet und das Working Directory auf /app/orchestrator gesetzt. Dadurch kann der Orchestrator die Module als Subprozesse starten.
  • Änderungen an den Modulen oder deren Abhängigkeiten erfordern einen Rebuild des orchestrator-Containers:
    docker-compose build orchestrator
docker-compose up
  • Die orchestrator/requirements.txt enthält alle Abhängigkeiten der Module (merge aller requirements.txt).

Beispiel für ein eigenes MCP-Modul

  1. Lege einen neuen Ordner nach Vorbild von mcp_proalpha an.
  2. Implementiere ein Tool mit FastMCP (siehe main.py in den Modulen).
  3. Trage das Modul in docker-compose.yml und ggf. in kunden.json ein.
  4. Nach dem Build kann das Modul dynamisch vom Orchestrator genutzt werden.

Hinweis: Die Module benötigen keine eigenen HTTP-Endpunkte mehr. Die Kommunikation läuft ausschließlich über das MCP-Protokoll (stdio) und den Orchestrator.

Entwicklung

Frontend lokal starten

cd frontend-react
npm install
npm start

Backend-Änderungen

  • Änderungen an Python-Code erfordern einen Neustart des jeweiligen Containers:
    docker-compose restart orchestrator mcp_proalpha mcp_hubspot mcp_docs

Hinweise

  • Die Kommunikation zwischen Orchestrator und Modulen erfolgt über das interne Docker-Netzwerk per Service-Name.
  • Die Discovery prüft, ob Module erreichbar sind, bevor Anfragen weitergeleitet werden.
  • API-Keys regeln den Zugriff pro Tenant.

Viel Spaß beim Ausprobieren!
Bei Fragen oder Problemen: Issues anlegen oder direkt im Code nachschauen.

相关 MCP