dsh-unity-debug-bridge

DSH ↔ Unity Editor ブレークポイントデバッグブリッジ：MCP server（stdio） の形で、Unity Editor のマネージドコード（Mono）のデバッグ機能を DSH agent に公開します —— エディタへのアタッチ、ブレークポイントの設定、ステップ実行、コールスタックの読み取り、読み取り専用評価。

機能

Related MCP server: rr-mcp

前提条件

• Node.js ≥ 18

• Unity Editor（対象プロジェクトを開いている）、スクリプトデバッグが有効（後述）

• DAP adapter： Unity-Technologies/vscode-unity-debug の master ブランチのソースからビルド（2019 年の Release バイナリは Unity 2022.3 をサポートしていない）、docs/adapter-contract.md を参照

DSH へのインストール

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

または DSH の MCP 設定で stdio サーバーを手動で追加：

- 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

使用の要点（ハマりポイント、必読）

1. セッションは必ずクリーンに終了し、繰り返し attach できる：Unity 2022.3 のデバッグエージェントは、セッションが強制的に中断（adapter を kill）されると、後続の attach を拒否します（接続後にハンドシェイクがなく、静かに失敗します）。エディタを再起動するしか復旧できません。unity_detach（グレースフル切断）でセッションを終了すれば、同じエディタに繰り返し attach でき、再起動は不要です。

2. TCP の事前チェックをしない：余分な接続（connect+close）はエージェントの状態を壊します。ポートを調べるには netstat を使用してください。ping 系のツールでデバッグポートに接続しないでください。

3. EditorAttach 設定：EditorPrefs "EditorAttach"=true はエディタ起動前に永続化されている必要があります（実行時の設定は無効です）。そうでないとデバッグエージェントがリッスンしません。エディタ内で EditorPrefs.SetBool("EditorAttach", true) を一度実行してからエディタを再起動してください。

4. デバッグポート：Editor のデバッグポート = 56000 + process_id % 1000（process_id は <project>/Library/EditorInstance.json から取得）。固定 56000 ではありません。

5. DAP 転送：Content-Length フレーム（行ごとの JSON ではない）。この adapter は configurationDone リクエストをサポートしていません。

詳細は docs/adapter-contract.md を参照。

ライセンス

MIT