mcp-registry/claude-debugs-for-you

    ==================
      
       /// MCP ///
      /// CLA ///
        
    ==================
        
    [server:online]
    [protocol:ready]

claude-debugs-for-you

by jasonjmcghee

VS Code extension + MCP server that lets Claude (or any LLM) drive the VS Code debugger through the Model Context Protocol, enabling interactive, language-agnostic debugging sessions.

389
32
Open Source
GitHubWebsite

01

debug

Launch and control a VS Code debugging session, letting the model set (including conditional) breakpoints, step through code, and evaluate expressions to diagnose problems in the user’s program.

Installation

1. Prerequisites
• Node.js ≥ 18
• npm (comes with Node)
• VS Code ≥ 1.86
• An Anthropic Claude API key or other LLM provider key supported by MCP
2. Clone the repository
git clone https://github.com/jasonjmcghee/claude-debugs-for-you.git cd claude-debugs-for-you
3. Install dependencies
npm install
4. Build the extension/server (generates the compiled TypeScript and the VSIX package)
npm run build
5. Supply credentials (Linux/macOS: ~/.bashrc, Windows: PowerShell $env)
export ANTHROPIC_API_KEY="<your-key>" # Optional: if you want to fall back to OpenAI set OPENAI_API_KEY, MODEL, etc.
6. Start the local MCP server
npm run mcp:server # typical script name; replace with the exact one in package.json # Server will listen on http://localhost:8000 by default (check console output)
7. Install the VS Code extension
a) From Marketplace: search for “Claude-Debugs-For-You” and click Install, or b) Locally: code --install-extension ./out/claude-debugs-for-you-*.vsix
8. Connect VS Code to the running MCP server
• Open the command palette → “Claude: Connect to Local MCP Server”
• Enter the URL (e.g., http://localhost:8000)
9. Usage
• Open any project folder.
• Highlight a failing test or section of code and run the “Claude: Debug Selection” command.
• The extension streams messages between Claude and the MCP server, applying patches automatically after confirmation.
10. Updating
git pull && npm install && npm run build

Documentation

License: MIT License
Updated 7/30/2025

Table of Contents