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 어댑터: 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 디버깅 agent는 세션이 강제로 중단(어댑터 kill)되면 이후 attach를 거부합니다(연결 후 핸드셰이크 없음, 조용히 실패). 편집기를 재시작해야만 복구됩니다. unity_detach(정상 연결 해제)로 세션을 종료하기만 하면 동일한 편집기에 반복적으로 attach할 수 있고 재시작할 필요가 없습니다.

2. TCP 사전 점검을 하지 마세요: 불필요한 연결(connect+close)은 agent 상태를 손상시킵니다. 포트 확인은 netstat을 사용하세요. ping 유형 도구로 디버깅 포트에 연결하지 마세요.

3. EditorAttach 설정: EditorPrefs "EditorAttach"=true는 편집기 시작 전에 영구 저장되어 있어야 합니다(런타임 설정은 무효). 그렇지 않으면 디버깅 agent가 수신 대기하지 않습니다. 편집기 내에서 EditorPrefs.SetBool("EditorAttach", true)를 한 번 실행한 후 편집기를 재시작하면 됩니다.

4. 디버깅 포트: Editor 디버깅 포트 = 56000 + process_id % 1000(process_id는 <project>/Library/EditorInstance.json에서 가져옴), 고정 56000이 아닙니다.

5. DAP 전송: Content-Length 프레임(한 줄씩이 아닌 JSON). 해당 어댑터는 configurationDone 요청을 지원하지 않습니다.

자세한 내용은 docs/adapter-contract.md를 참조하세요.

라이선스

MIT