Skip to main content
Glama
deenesjakoruzh
goesByhc

dsh-unity-debug-bridge

by goesByhc
OverviewSchemaSourceRelated ServersDiscussionsAdmin
JavaScript
Local

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

Herramienta

Descripción

unity_attach

Se adjunta al Unity Editor (descubre automáticamente el proceso y el puerto leyendo Library/EditorInstance.json)

unity_set_breakpoint / unity_continue

Punto de interrupción; continue se bloquea hasta que se alcanza y devuelve stopped; con resumeAfterStop=true se reanuda automáticamente tras el alto (modo IA); por defecto se detiene (modo de observación humana)

unity_step / unity_step_in / unity_step_out / unity_pause

Ejecución paso a paso y pausa

unity_stack / unity_scopes / unity_variables

Pila de llamadas y variables

unity_evaluate

Evaluación de solo lectura (context=watch, prohibido modificar el estado)

unity_status / unity_detach

Estado de la sesión y limpieza

Related MCP server: re-dotnet-patch

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

This server cannot be deployed

Shareable, User-Owned Context BackendPeople, applications, and agents read, write, and coordinate together in one context lake. Reach it over MCP, a CLI, a Python SDK, or REST.fulcradynamics.comAd

Maintenance

ActivitySlowing
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • Unity-MCP

    IvanMurzak
    A
    license
    Not graded
    quality
    A
    maintenance
    Seamless automation and intelligent control over your Unity projects. By integrating with the MCP server and client, it allows AI agents or external tools to interact with your Unity environment—creating, modifying, and managing GameObjects, Components, Assets, Scenes, and more.
    4,455
    Apache 2.0

  • Unity Debugger Pure MCP

    kpkhxlgy0
    A
    license
    Not graded
    quality
    A
    maintenance
    Provides MCP tools to manage and interact with Unity debug sessions in VS Code, including breakpoints, snapshots, evaluation, and stepping, via a named pipe to the Unity Debugger Pure extension.
    MIT

  • UnityMCP

    zloybest
    F
    license
    Not graded
    quality
    B
    maintenance
    Local Streamable HTTP MCP server exposing Unity Editor inspection, authoring, testing, profiling, play-mode, and build tools.
    -