ModMind MCP Server

Dieses Verzeichnis ist die veröffentlichbare MCP-Protokollschicht, die aus ModMind extrahiert wurde. Es implementiert einen lokalen stdio-Server unter Verwendung von JSON-RPC-MCP-Methoden und leitet Tool-Aufrufe an eine bereits laufende ModMind-Bridge über Loopback-HTTP weiter.

Der erste Snapshot folgt der ModMind-Desktop-Linie bei 1.3.4; die Paketversion (0.1.0) ist unabhängig und sollte erhöht werden, wenn sich der öffentliche Bridge-Vertrag ändert.

Der Server enthält bewusst keinen Electron-Code, keine Anbieter-Anmeldeinformationen, keine Projektdaten, keine Protokolle, keine gebündelten Minecraft-Binärdateien und keine Abhängigkeiten von Drittanbieter-Laufzeiten. Es ist kein eigenständiges Minecraft-Automatisierungs-Backend: Eine kompatible Bridge muss den Aktionsvertrag in docs/bridge-contract.md implementieren.

Lokal ausführen

Node.js 18.18 oder neuer ist erforderlich.

npm test
$env:MODMIND_BRIDGE_CONFIG = "C:\path\to\project\.modmind\external-agents\bridge.json"
node .\src\mcp-server.mjs

MCP-Clients starten den Prozess und kommunizieren über zeilengetrenntes JSON auf stdin/stdout. Schreiben Sie keine Logs auf stdout; stdout ist der Protokollkanal.

Related MCP server: mcp-stdio

Client-Konfiguration

Kopieren Sie examples/mcp-config.json, ersetzen Sie beide Pfade und importieren Sie es in einen Client, der lokale stdio-MCP-Server unterstützt. Die Desktop-Anwendung erstellt normalerweise bridge.json und die projektspezifische Konfiguration automatisch. MODMIND_BRIDGE_CONFIG ist optional, wenn bridge.json neben mcp-server.mjs liegt.

Informationen zum Startbefehl des ModMind-Desktop-Hosts, zur Projektauswahl, zum Lebenszyklus, zur Aktionszuordnung und zu den Kompatibilitätsanforderungen finden Sie in docs/external-bridge-integration.zh-CN.md.

Sicherheitsmodell

Die Bridge bindet an 127.0.0.1 und erfordert einen zufälligen, sitzungsbezogenen Token im x-modmind-token-Header. Behandeln Sie bridge.json als Geheimnis, entfernen Sie es nach Sitzungsende und setzen Sie den Bridge-Port niemals außerhalb des lokalen Rechners frei. Der MCP-Server entscheidet nicht, ob eine Schreib-/Build-Aktion erlaubt ist; diese Richtlinie gehört zur Host-Anwendung und ihrem Review-Adapter.

Aktueller Status

Der Quellcode spiegelt die aktuellen ModMind-Tool-Namen und die Aktionszuordnung wider. Der öffentliche Aktionsvertrag wird absichtlich getrennt von der Desktop-App versioniert. Vor der Veröffentlichung einer Version führen Sie die Vorbereitungs-Checkliste in docs/open-source-preparation.zh-CN.md aus.