Claude depura por ti

También conocido como depuración de vibraciones

Permita que Claude (o cualquier otro LLM) depure su código de forma interactiva

Esta es una extensión de MCP Server y VS Code que permite a Claude depurar y evaluar expresiones de forma interactiva.

Eso significa que también debería funcionar con otros modelos/clientes, etc., pero solo lo demuestro con Claude Desktop y Continúo aquí.

Es independiente del lenguaje y supone soporte para la consola del depurador y un launch.json válido para la depuración en VSCode.

Empezando

1. Descargue la extensión desde las versiones o VS Code Marketplace

2. Instalar la extensión

• Si usa .vsix directamente, vaya a los tres puntos en "Extensiones" en VS Code y elija "Instalar desde VSIX..."

3. Verá un nuevo elemento de menú de estado "Claude Debugs For You" que muestra si se está ejecutando correctamente (verificar) o si no se pudo iniciar (x)

Puede hacer clic en este menú de estado para ver los comandos disponibles

Siga una de las opciones a continuación, según su configuración

4. Copie la ruta del servidor stdio al portapapeles buscando en los comandos de vs code "Copiar la ruta stdio del servidor de depuración de MCP al portapapeles".

5. Pegue lo siguiente (¡PERO ACTUALIZA LA RUTA A LA COPIADA!) en su claude_desktop_config.json o edítelo según corresponda si usa otros servidores MCP

{
  "mcpServers": {
    "debug": {
      "command": "node",
      "args": [
        "/path/to/mcp-debug.js"
      ]
    }
  }
}

6. Inicie el escritorio de Claude (u otro cliente MCP)

   1. Nota: Es posible que tengas que reiniciarlo si ya estaba ejecutándose.

   2. Puede omitir este paso si usa Continuar/Cursor u otra función integrada en VS Code

7. Recupere la dirección sse del servidor MCP mediante el comando "Copiar la dirección sse del servidor de depuración MCP al portapapeles"

   1. Puedes simplemente escribir la URL del servidor " http://localhost:4711/sse ", o cualquier puerto que configures en la configuración.

8. Agréguelo donde lo necesite según su cliente.

   1. Es posible que necesites presionar "actualizar" dependiendo del cliente: esto es necesario en Cursor

9. Iniciar el cliente MCP

   1. Nota: Es posible que tengas que reiniciarlo si ya estaba ejecutándose.

   2. Puede omitir este paso si usa Continuar/Cursor u otra función integrada en VS Code

¡Estás listo para depurar!

Documentación de depuración de VS Code

Abra un proyecto que contenga un .vscode/launch.json con la primera configuración establecida para depurar un archivo específico con ${file} .

Vea "Ejecutar un ejemplo" a continuación y/o mire un video de demostración.

Related MCP server: gdb-cli

Contribuyendo

¿Encontraste errores o tienes alguna idea para mejorar esto? Abre una solicitud de incorporación de cambios o registra un problema.

¿Este archivo README es malo? ¡Ayúdenme a mejorarlo!

Manifestación

Usando Continuar

Detecta el problema y luego sugiere una solución, que simplemente hacemos clic para aplicar.

https://github.com/user-attachments/assets/3a0a879d-2db7-4a3f-ab43-796c22a0f1ef

¡Lea los documentos!

Configuración:

{
  ...
  "experimental": {
    "modelContextProtocolServers": [
      {
        "transport": {
          "type": "stdio",
          "command": "node",
          "args": [
            "/Users/jason/Library/Application Support/Code/User/globalStorage/jasonmcghee.claude-debugs-for-you/mcp-debug.js"
          ]
        }
      }
    ]
  }
}

También necesitarás elegir un modelo capaz de utilizar herramientas.

Cuando aparezca la lista de herramientas, asegúrese de hacer clic en "depurar" en la lista de sus herramientas y configúrelo en "Automático".

Solución de problemas

Si ve errores de MCP al continuar, intente deshabilitar/volver a habilitar el complemento de continuación

Si te sirve de ayuda, ¡así es mi configuración! Pero es casi igual a la de Claude Desktop.

Uso de Claude Desktop

En este ejemplo, lo hice intencionalmente muy cauteloso (no hacer suposiciones, etc.; el mismo mensaje que a continuación), pero puedes pedirle que haga lo que quieras.

https://github.com/user-attachments/assets/ef6085f7-11a2-4eea-bb60-b5a54873b5d5

Desarrollo

• Clonar/Abrir este repositorio con VS Code

• Ejecute npm run install y npm run compile

• Presione "Ejecutar" lo que abrirá un nuevo VSCode

• De lo contrario, es igual que "Se aplica Primeros pasos".

• Para reconstruir, npm run compile

Paquete

vsce package

Ejecutar un ejemplo

Abrir examples/python en una ventana de VS Code

Introduzca el mensaje:

i am building `longest_substring_with_k_distinct` and for some reason it's not working quite right. can you debug it step by step using breakpoints and evaluating expressions to figure out where it goes wrong? make sure to use the debug tool to get access and debug! don't make any guesses as to the problem up front. DEBUG!

Otras cosas que vale la pena mencionar

Al iniciar varias ventanas de vs.code, verá una ventana emergente. Puede transferir fácilmente "Claude depura por usted" entre ventanas.

También puedes desactivar el inicio automático. Luego, solo tendrás que hacer clic en el menú de estado y seleccionar "Iniciar servidor".

Lista corta de ideas

• [ ] Debería usar ripgrep para encontrar lo que solicita, en lugar de enumerar archivos + obtener el contenido del archivo.

• [x] Agregar soporte para puntos de interrupción condicionales

• [ ] Agregue la herramienta "corregir" permitiendo que MCP inserte una sugerencia de CodeLens o "corrección automática" para que el usuario pueda elegir aplicar un cambio recomendado o no.

• ¡Tu idea aquí!