Skip to main content
Glama
deenesjakoruzh
waterpail114514

ModMind MCP Server

by waterpail114514
OverviewSchemaSourceRelated ServersDiscussionsAdmin
JavaScript
Local

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-streaming-http-proxy

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.

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityMaintained
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • affinity-mcp-proxy

    MaddozS
    A
    license
    Not graded
    quality
    C
    maintenance
    Proxies the local Affinity MCP server over stdio, enabling tools to call Affinity's tools like execute_script and search_sdk_hints via MCP.
    18 npm
    4
    MIT

  • mcp-remote

    abluva
    A
    license
    Not graded
    quality
    A
    maintenance
    Bridge that lets stdio-only MCP clients connect to remote MCP servers with OAuth and other auth support, enabling local clients to use remote, authorized MCP servers.
    43 npm
    54
    MIT

  • proxycept-mcp

    MoathOthman
    A
    license
    Not graded
    quality
    C
    maintenance
    A thin stdio-to-HTTP bridge that forwards MCP messages to the hosted Proxycept server, enabling stdio-only MCP clients to access Proxycept's tool catalog.
    9 npm
    MIT