dsh-unity-debug-bridge

DSH ↔ Unity Editor — мост отладки по точкам останова: в форме MCP server (stdio) предоставляет агенту DSH возможности отладки управляемого кода (Mono) в Unity Editor — подключение к редактору, установка точек останова, пошаговое выполнение, чтение стека вызовов, оценка только для чтения.

Возможности

Related MCP server: rr-mcp

Предварительные требования

• Node.js ≥ 18

• Unity Editor (целевой проект открыт), отладка скриптов включена (см. ниже)

• DAP adapter: собран из исходников ветки master репозитория Unity-Technologies/vscode-unity-debug (бинарные релизы 2019 года не поддерживают Unity 2022.3), см. docs/adapter-contract.md

Установка в DSH

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

Или добавьте stdio-сервер вручную в настройках MCP в DSH:

- 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 после грубого прерывания сеанса (kill adapter) отказывает в последующем 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