VSCode Debug MCP

Una extensión de VS Code y CLI que exponen el Protocolo de Adaptador de Depuración (DAP) de VS Code como herramientas MCP, de modo que un agente de IA de codificación pueda establecer puntos de interrupción, avanzar paso a paso por el código, inspeccionar variables y leer excepciones en una sesión de depuración real.

Créditos

Este proyecto es una reescritura desde cero, iniciada como un análisis de e inspirada por mcp-debug-tools de Hwanyong Yoo. No se copió código fuente textualmente (aparte de unos pocos archivos de utilidad pequeños y funcionalmente triviales); los puntos de integración de VS Code (activación, comandos, contributes) y el enfoque CLI/detección se usaron como referencia mientras se rediseñaban desde cero el seguimiento de DAP, el manejo de sesiones y la seguridad del servidor. Licencia GPL-3.0, igual que el original.

Por qué una reescritura

Un análisis de la herramienta original encontró varios problemas que no valía la pena parchear en el lugar:

• El seguimiento de mensajes DAP era un stub que siempre devolvía valores de relleno para get-dap-log, get-debug-console y get-exception-info, nunca datos reales.

• Una única instancia compartida de McpServer manejaba cada sesión de cliente, causando que una segunda conexión concurrente se colgara indefinidamente.

• El servidor HTTP no tenía autenticación y deshabilitaba la protección contra rebinding de DNS.

• logMessage (logpoints) se aceptaba pero nunca se aplicaba realmente.

• Detener o reiniciar el servidor mediante comando dejaba el archivo de configuración en disco apuntando a un puerto obsoleto.

• Dos archivos package.json se intercambiaban antes de cada compilación, lo que provocó que una dependencia de tiempo de ejecución requerida quedara sin declarar en todas las versiones publicadas.

Todos estos problemas están corregidos aquí; consulte CHANGELOG.md para la lista.

Desarrollo

npm install
npm run build       # esbuild -> out/extension.js, out/cli.js
npm run typecheck    # tsc --noEmit
npm run lint

Ejecute la extensión: abra esta carpeta en VS Code y presione F5 (Host de desarrollo de extensión).

Ejecute el CLI de forma independiente: node out/cli.js <comando> [argumentos] - consulte resources/skills/dap-cli-debugging.md para la referencia completa de comandos y herramientas.

Empaquetado e instalación

Para crear un paquete .vsix instalable para VS Code:

npx @vscode/vsce package

Esto generará un archivo vscode-mcp-dap-debugger-X.Y.Z.vsix en la raíz del repositorio. Puede instalarlo en VS Code a través de la interfaz de usuario (Extensiones -> ... -> Instalar desde VSIX...) o desde la línea de comandos:

code --install-extension vscode-mcp-dap-debugger-*.vsix

Modelo de seguridad

El servidor HTTP se vincula solo a 127.0.0.1, mantiene la protección contra rebinding de DNS habilitada y requiere un token de autenticación por instancia (generado al inicio, escrito en .vscode-mcp-dap-debugger/config.json del espacio de trabajo y en ~/.vscode-mcp-dap-debugger/active-configs.json) en cada solicitud. El CLI descubre el token de la misma manera que descubre el puerto. Esto no pretende ser una autenticación fuerte; es una protección contra que otro proceso local o usuario se tope con el puerto y controle el depurador (incluyendo la ejecución de expresiones arbitrarias mediante evaluate-expression) sin haber tenido antes acceso al sistema de archivos de este espacio de trabajo.