Claude Debugs for You

v1.0.0Developer Toolsstable

Enable Claude (or any other LLM) to interactively debug your code (set breakpoints and evaluate expressions in stack frame). It's language-agnostic, assuming debugger console support and valid launch.json for debugging in VSCode.

anthropicautodebugautomationclaudecontext
Share:
510
Stars
0
Downloads
0
Weekly
0/5

What is Claude Debugs for You?

Claude Debugs for You is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to enable claude (or any other llm) to interactively debug your code (set breakpoints and evaluate expressions in stack frame). it's language-agnostic, assuming debugger console support and valid launch....

Enable Claude (or any other LLM) to interactively debug your code (set breakpoints and evaluate expressions in stack frame). It's language-agnostic, assuming debugger console support and valid launch.json for debugging in VSCode.

This server falls under the Developer Tools category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

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

Use Cases

Interactive debugging with Claude
Breakpoint setting and expression evaluation
VSCode launch.json integration
jasonjmcghee

Maintainer

LicenseMIT License
Languagetypescript
Versionv1.0.0
UpdatedMay 12, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

Manual Installation

npx claude-debugs-for-you

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use Claude Debugs for You

Claude Debugs For You is a VS Code extension and MCP server that enables Claude (or any MCP-compatible LLM client) to interactively debug code by setting breakpoints, evaluating expressions in stack frames, and stepping through execution — all through the MCP protocol. It is language-agnostic as long as your debugger has console support and you have a valid .vscode/launch.json configured. Developers use it to let Claude autonomously diagnose bugs by observing actual runtime state rather than guessing from static code analysis.

Prerequisites

  • Visual Studio Code installed with the 'Claude Debugs For You' extension (install from VS Code Marketplace or from a .vsix release)
  • A project with a .vscode/launch.json configured for debugging (the first configuration should use ${file} to debug the current file)
  • Claude Desktop or another MCP client (also works with Continue, Cursor via SSE)
  • Node.js installed (the MCP server is a Node.js process started by the VS Code extension)
  • A supported debugger for your language (Python debugpy, Node.js built-in, etc.)
1

Install the VS Code extension

Install 'Claude Debugs For You' from the VS Code Marketplace, or download the .vsix file from GitHub Releases and install it via Extensions → three dots → Install from VSIX. The extension starts an MCP debug server automatically when VS Code opens.

# Install from VS Code Marketplace:
# Search for 'Claude Debugs For You' in the Extensions panel
# Or install from VSIX:
# Extensions panel → ⋯ → Install from VSIX...
2

Copy the MCP server path from VS Code

After the extension installs, open the VS Code command palette (Cmd+Shift+P / Ctrl+Shift+P) and run 'Copy MCP Debug Server stdio path to clipboard'. You will need this path for your MCP client config.

# VS Code Command Palette:
# > Copy MCP Debug Server stdio path to clipboard
3

Add the debug server to Claude Desktop

Edit your claude_desktop_config.json and paste the copied path as the node script argument. Use the stdio transport for Claude Desktop.

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

Open a project with a launch.json

Open the project you want to debug in VS Code. Ensure .vscode/launch.json exists and the first configuration is set up to debug a specific file using the ${file} variable.

{
  "version": "0.2.0",
  "configurations": [
    {
      "name": "Debug Current File",
      "type": "python",
      "request": "launch",
      "program": "${file}"
    }
  ]
}
5

Ask Claude to debug interactively

Start Claude Desktop (restart if it was already open) and ask Claude to debug your code. Claude will use the MCP debug tools to set breakpoints and evaluate expressions autonomously.

Claude Debugs for You Examples

Client configuration

Claude Desktop configuration for the debug MCP server. The exact path to mcp-debug.js comes from the 'Copy MCP Debug Server stdio path' VS Code command.

{
  "mcpServers": {
    "debug": {
      "command": "node",
      "args": [
        "/Users/yourname/Library/Application Support/Code/User/globalStorage/jasonmcghee.claude-debugs-for-you/mcp-debug.js"
      ]
    }
  }
}

Prompts to try

Paste these prompts into Claude Desktop with the debug server connected and your project open in VS Code.

- "I am building longest_substring_with_k_distinct and it's not working right. Debug it step by step using breakpoints and evaluating expressions to figure out where it goes wrong. Don't guess — use the debug tool."
- "Set a breakpoint at line 42 of utils.py and evaluate the value of 'result' at that point"
- "This function returns the wrong value for edge cases. Step through the execution with my test input and find where the logic diverges"
- "Evaluate the entire local scope in the current stack frame and tell me which variable looks wrong"

Troubleshooting Claude Debugs for You

The VS Code status bar shows an 'x' instead of a checkmark for 'Claude Debugs For You'

The MCP debug server failed to start. Click the status bar item to see available commands, then click 'Start Server'. Check that Node.js is installed and accessible in your PATH. You can also disable autostart in extension settings and start it manually.

Multiple VS Code windows open at the same time cause conflicts

When you open a second VS Code window, a pop-up will appear asking which window should own the debug server. You can gracefully hand off 'Claude Debugs For You' between windows using that prompt.

MCP errors appear in Continue or Cursor even though the extension is running

For Cursor, use the SSE transport (http://localhost:4711/sse) instead of stdio. Run the 'Copy MCP Debug Server sse address to clipboard' command and add that URL to Cursor's MCP configuration. After adding, click 'Refresh' in Cursor's MCP panel.

Frequently Asked Questions about Claude Debugs for You

What is Claude Debugs for You?

Claude Debugs for You is a Model Context Protocol (MCP) server that enable claude (or any other llm) to interactively debug your code (set breakpoints and evaluate expressions in stack frame). it's language-agnostic, assuming debugger console support and valid launch.json for debugging in vscode. It connects AI assistants to external tools and data sources through a standardized interface.

How do I install Claude Debugs for You?

Follow the installation instructions on the Claude Debugs for You GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with Claude Debugs for You?

Claude Debugs for You works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is Claude Debugs for You free to use?

Yes, Claude Debugs for You is open source and available under the MIT License license. You can use it freely in both personal and commercial projects.

Browse More Developer Tools MCP Servers

Explore all developer tools servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Quick Config Preview

{ "mcpServers": { "claude-debugs-for-you": { "command": "npx", "args": ["-y", "claude-debugs-for-you"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use Claude Debugs for You?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides