dsh-unity-debug-bridge

Puente de depuración por puntos de interrupción DSH ↔ Unity Editor: expone las capacidades de depuración del código administrado (Mono) del Unity Editor al agente DSH en forma de MCP server (stdio) — adjuntar al editor, establecer puntos de interrupción, ejecutar paso a paso, leer la pila de llamadas, evaluación de solo lectura.

Capacidades

Related MCP server: rr-mcp

Requisitos previos

• Node.js ≥ 18

• Unity Editor (con el proyecto de destino abierto), depuración de scripts habilitada (ver más abajo)

• Adaptador DAP: compilado desde el código fuente de la rama master de Unity-Technologies/vscode-unity-debug (los binarios de Release de 2019 no son compatibles con Unity 2022.3), ver docs/adapter-contract.md

Instalación en DSH

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

O agregar manualmente un servidor stdio en la configuración MCP de 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

Puntos de uso (lecciones de la práctica, lectura obligatoria)

1. La sesión debe finalizar limpiamente y puede volver a adjuntarse: el agente de depuración de Unity 2022.3 rechaza los adjuntos posteriores si la sesión se interrumpe bruscamente (matar el adaptador) (no hay handshake tras la conexión, falla en silencio), y solo se recupera reiniciando el editor. Si la sesión se termina con unity_detach (desconexión ordenada), el mismo editor se puede adjuntar repetidamente sin reiniciar.

2. No hacer comprobaciones previas TCP: cualquier conexión adicional (connect+close) daña el estado del agente; para consultar el puerto usa netstat. No uses herramientas tipo ping para conectar al puerto de depuración.

3. Preferencia EditorAttach: EditorPrefs "EditorAttach"=true debe estar persistido antes de que el editor se inicie (la configuración en tiempo de ejecución no tiene efecto), de lo contrario el agente de depuración no escucha. Puedes ejecutar una vez EditorPrefs.SetBool("EditorAttach", true) dentro del editor y luego reiniciar el editor.

4. Puerto de depuración: el puerto de depuración del Editor = 56000 + process_id % 1000 (process_id proviene de <project>/Library/EditorInstance.json), no es el fijo 56000.

5. Transporte DAP: tramas Content-Length (no JSON por líneas); este adaptador no soporta la solicitud configurationDone.

Más detalles en docs/adapter-contract.md.

Licencia

MIT