dsh-unity-debug-bridge

DSH ↔ Unity Editor Breakpoint-Debug-Brücke: Stellt die Debug-Fähigkeiten des verwalteten Unity-Editor-Codes (Mono) als MCP-Server (stdio) für DSH-Agenten bereit — Anhängen an den Editor, Setzen von Haltepunkten, Einzelschritt, Lesen des Aufrufstapels, Nur-Lese-Auswertung.

Fähigkeiten

Related MCP server: rr-mcp

Voraussetzungen

• Node.js ≥ 18

• Unity Editor (mit geöffnetem Zielprojekt), Skript-Debugging aktiviert (siehe unten)

• DAP-Adapter: aus dem Unity-Technologies/vscode-unity-debug Master-Zweig aus dem Quellcode erstellen (die Release-Binaries von 2019 unterstützen Unity 2022.3 nicht), siehe docs/adapter-contract.md

Installation in DSH

node install.mjs
# 然后重启 DSH，/mcp 面板出现 unity-debug-bridge（13 个 unity_* 工具）

Oder den stdio-Server manuell in den MCP-Einstellungen von DSH hinzufügen:

- insert:
    - id: mcp-unity-debug-bridge
      name: "@deepseek-ai/dsh-mcp-client"
      config:
        serverName: unity-debug-bridge
        transport: stdio
        command: node
        args: ["<本包路径>/server/mcp-server-stdio.mjs"]
        cwd: "<本包路径>"
        toolCallTimeoutMs: 120000

Wichtige Hinweise zur Verwendung (Erfahrungen aus der Praxis, unbedingt lesen)

1. Sitzung muss sauber beendet werden, wiederholtes Attach ist möglich: Der Unity-2022.3-Debug-Agent lehnt nach einem brutalen Abbruch der Sitzung (Adapter killen) spätere Attach-Versuche ab (nach der Verbindung kein Handshake, stiller Fehlschlag); nur ein Neustart des Editors stellt es wieder her. Solange die Sitzung über unity_detach (sauberes Trennen) beendet wird, kann derselbe Editor wiederholt attachiert werden, ohne ihn neu starten zu müssen.

2. Keine TCP-Vorabprüfung durchführen: Jede überflüssige Verbindung (connect+close) zerstört den Agent-Zustand; zum Prüfen des Ports netstat verwenden. Keine Ping-ähnlichen Werkzeuge verwenden, um den Debug-Port zu verbinden.

3. EditorAttach-Einstellung: EditorPrefs "EditorAttach"=true muss vor dem Start des Editors bereits persistent gesetzt sein (zur Laufzeit gesetzt ist wirkungslos), andernfalls hört der Debug-Agent nicht zu. Man kann einmalig EditorPrefs.SetBool("EditorAttach", true) im Editor ausführen und den Editor dann neu starten.

4. Debug-Port: Der Editor-Debug-Port = 56000 + process_id % 1000 (process_id aus <project>/Library/EditorInstance.json), nicht fest 56000.

5. DAP-Übertragung: Content-Length-Frames (kein zeilenweises JSON); dieser Adapter unterstützt die configurationDone-Anfrage nicht.

Siehe docs/adapter-contract.md.

Lizenz

MIT