Claude Debugs For You

Enable Claude (or any other LLM) to interactively debug your code

This is an MCP Server and VS Code extension which enables claude to interactively debug and evaluate expressions. That means it should also work with other models / clients etc. but I only demonstrate it with Claude Desktop here. It's language-agnostic, assuming debugger console support and valid launch.json for debugging in VSCode.

Getting Started

1. Download the extension from releases or VS Code Marketplace
2. Install the extension

• If using .vsix directly, go to the three dots in "Extensions" in VS Code and choose "Install from VSIX..."

3. Open a project containing a .vscode/launch.json with the first configuration setup to debug a specific file with ${file}.
4. On startup, a popup will show that the debug server started and a path to the node binary

If using node process based method (required for Claude Desktop)

5. Copy the path of the node binary to mcp-debug.js in the popup

6. Paste the following (BUT UPDATE THE PATH TO THE COPIED ONE!) in your claude_desktop_config.json or edit accordingly if you use other MCP servers

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

7. Start Claude desktop (or other MCP client)

If using /sse based method (e.g. Cursor)

4. Add the MCP server using the server URL of " http://localhost:4711/sse", or whatever port you setup in settings.

5. Start MCP client

You're ready to debug!

See Run an Example below, and/or watch a demo video.

Contributing

Find bugs or have an idea that will improve this? Please open a pull request or log an issue.

Demo

Using Continue

It figures out the problem, and then suggests a fix, which we just click to apply

Troubleshooting

If you are seeing MCP errors in continue, try disabling / re-enabling the continue plugin

Developing

• Clone / Open this repo with VS Code
• Run npm run install and npm run compile
• Hit "run" which will open a new VSCode
• Otherwise same as "Getting Started applies"
• To rebuild, npm run compile

Package

vsce package

Run an Example

Open examples/python in a VS Code window

Enter the prompt:

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!

Configuration

There's a hidden env var you can use to set the port on the MCP side.

"debug": {
  "command": "node",
  "args": [\
    "/path/to/mcp-debug.js"\
  ],
  "env": {
    "MCP_DEBUGGER_PORT": 4711
  }
}

And similarly you may set the port on the vs code side using extensions settings or JSON:

"mcpDebug.port": 4711

Short list of ideas

• [ ] It should use ripgrep to find what you ask for, rather than list files + get file content.
• [x] Add support for conditional breakpoints
• [ ] Add "fix" tool by allowing MCP to insert a CodeLens or "auto fix" suggestion so the user can choose to apply a recommended change or not.

About

Enable any LLM (e.g. Claude) to interactively debug any language for you via MCP and a VS Code Extension

Topics

debugging automation model mcp protocol vscode context debug vscode-extension debugging-tool claude llm anthropic model-context-protocol autodebug

License

MIT license