Claude Debugs For You
Enable LLMs like Claude to interactively debug code via a VS Code extension and MCP server.
Key Features
Use Cases
README
Claude Debugs For You
aka Vibe Debugging
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 and Continue here.
It's language-agnostic, assuming debugger console support and valid launch.json for debugging in VSCode.
Getting Started
- Download the extension from releases or VS Code Marketplace
- Install the extension
- If using
.vsixdirectly, go to the three dots in "Extensions" in VS Code and choose "Install from VSIX..."
- You will see a new status menu item "Claude Debugs For You" which shows if it is running properly (check) or failed to startup (x)
You can click this status menu for the commands available
Follow one of the options below, depending on your setup
-
Copy the stdio server path to your clipboard by searching vs code commands for "Copy MCP Debug Server stdio path to clipboard"
-
Paste the following (BUT UPDATE THE PATH TO THE COPIED ONE!) in your
claude_desktop_config.jsonor edit accordingly if you use other MCP servers
{
"mcpServers": {
"debug": {
"command": "node",
"args": [
"/path/to/mcp-debug.js"
]
}
}
}
- Start Claude desktop (or other MCP client)
- Note: You may need to restart it, if it was already running.
- You can skip this step if using Continue/Cursor or other built-in to VS Code
- Retrieve the MCP server sse address by using the "Copy MCP Debug Server sse address to clipboard" command
- You can just write it out server URL of "http://localhost:4711/sse", or whatever port you setup in settings.
- Add it wherever you need to based on your client
- You may need to hit "refresh" depending on client: this is required in Cursor
- Start MCP client
- Note: You may need to restart it, if it was already running.
- You can skip this step if using Continue/Cursor or other built-in to VS Code
You're ready to debug!
VS Code Debugging Documentation
Open a project containing a .vscode/launch.json with the first configuration setup to debug a specific file with ${file}.
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.
Does this readme suck? Help me improve it!
Demo
Using Continue
It figures out the problem, and then suggests a fix, which we just click to apply
https://github.com/user-attachments/assets/3a0a879d-2db7-4a3f-ab43-796c22a0f1ef
Configuration:
{
...
"experimental": {
"modelContextProtocolServers": [
{
"transport": {
"type": "stdio",
"command": "node",
"args": [
"/Users/jason/Library/Application Support/Code/User/globalStorage/jasonmcghee.claude-debugs-for-you/mcp-debug.js"
]
}
}
]
}
}
You'll also need to choose a model capable of using tools.
When the list of tools pops up, make sure to click "debug" in the list of your tools, and set it to be "Automatic".
Troubleshooting
If you are seeing MCP errors in continue, try disabling / re-enabling the continue plugin
If helpful, this is what my configuration looks like! But it's nearly the same as Claude Desktop.
Using Claude Desktop
In this example, I made it intentionally very cautious (make no assumptions etc - same prompt as below) but you can ask it to do whatever.
https://github.com/user-attachments/assets/ef6085f7-11a2-4eea-bb60-b5a54873b5d5
Developing
- Clone / Open this repo with VS Code
- Run
npm run installandnpm 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!
Other things worth mentioning
When you start multiple vs code windows, you'll see a pop-up. You can gracefully hand-off "Claude Debugs For You" between windows.
You can also disable autostart. Then you'll just need to click the status menu and select "Start Server".
Short list of ideas
- It should use ripgrep to find what you ask for, rather than list files + get file content.
- 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.
- Your idea here!
Star History
Repository Owner
User
Repository Details
Programming Languages
Tags
Topics
Join Our Newsletter
Stay updated with the latest AI tools, news, and offers by subscribing to our weekly newsletter.
Related MCPs
Discover similar Model Context Protocol servers
Bifrost
VSCode Dev Tools exposed via the Model Context Protocol for AI tool integration.
Bifrost is a Visual Studio Code extension that launches a Model Context Protocol (MCP) server, enabling external AI coding assistants to access advanced code navigation, analysis, and manipulation features from VSCode. It exposes language server capabilities, symbol search, semantic code analysis, and refactoring tools through MCP-compatible HTTP and SSE endpoints. The extension is designed for seamless integration with AI assistants, supporting multi-project environments and configuration via JSON files.
- ⭐ 184
- MCP
- biegehydra/BifrostMCP
MCP Claude Code
Claude Code-like functionality via the Model Context Protocol.
Implements a server utilizing the Model Context Protocol to enable Claude Code functionality, allowing AI agents to perform advanced codebase analysis, modification, and command execution. Supports code understanding, file management, and integration with various LLM providers. Offers specialized tools for searching, editing, and delegating tasks, with robust support for Jupyter notebooks. Designed for seamless collaboration with MCP clients including Claude Desktop.
- ⭐ 281
- MCP
- SDGLBL/mcp-claude-code
LLDB-MCP
AI-assisted debugging with LLDB via Model Context Protocol integration
LLDB-MCP enables integration of the LLDB debugger with Claude's Model Context Protocol, allowing for direct control and interaction with LLDB debugging sessions through AI. The tool offers a suite of commands for managing sessions, examining program state, and controlling execution. It facilitates natural language interaction with LLDB, streamlining tasks such as loading executables, setting breakpoints, and analyzing stack traces. Designed for seamless AI-assisted debugging workflows, LLDB-MCP enhances productivity by bridging advanced debugging capabilities with AI-driven interfaces.
- ⭐ 63
- MCP
- stass/lldb-mcp
Lucidity MCP
Intelligent prompt-based code quality analysis for AI coding assistants.
Lucidity MCP is a Model Context Protocol (MCP) server that empowers AI coding assistants to deliver high-quality code through intelligent, prompt-driven analysis. It offers comprehensive detection of code issues across multiple quality dimensions, providing structured and actionable feedback. With language-agnostic capabilities, extensible framework, and flexible transport options, Lucidity MCP seamlessly integrates into developer workflows and AI systems.
- ⭐ 72
- MCP
- hyperb1iss/lucidity-mcp
Exa MCP Server
Fast, efficient web and code context for AI coding assistants.
Exa MCP Server provides a Model Context Protocol (MCP) server interface that connects AI assistants to Exa AI’s powerful search capabilities, including code, documentation, and web search. It enables coding agents to retrieve precise, token-efficient context from billions of sources such as GitHub, StackOverflow, and documentation sites, reducing hallucinations in coding agents. The platform supports integration with popular tools like Cursor, Claude, and VS Code through standardized MCP configuration, offering configurable access to various research and code-related tools via HTTP.
- ⭐ 3,224
- MCP
- exa-labs/exa-mcp-server
Unity MCP
AI-powered game development assistant bridging MCP and Unity.
Unity MCP serves as an AI-powered assistant for game developers, acting as a bridge between MCP clients and the Unity engine. It enables natural chat-based interactions to perform various development tasks using large language models from multiple providers. The system offers tools for code assistance, debugging, and flexible deployment options, supporting both local and remote workflows. Its extensibility allows for the creation of custom MCP tools to enhance developer productivity in the Unity environment.
- ⭐ 510
- MCP
- IvanMurzak/Unity-MCP
Didn't find tool you were looking for?