Claude Debugs For You

15 forks

197 stars

Free

What is claude-debugs-for-you

claude-debugs-for-you is an innovative tool developed by jasonjmcghee, designed to enhance your coding experience by enabling interactive debugging through language models like Claude. This MCP (Model Context Protocol) Server and Visual Studio Code extension allows AI to assist in debugging your code by evaluating expressions and providing insights in real-time. The server is language-agnostic, making it versatile for developers dealing with various programming languages, as long as they have debugger console support and a valid launch.json configuration file in their projects.

How to Use claude-debugs-for-you

To get started with claude-debugs-for-you, follow these simple steps:

Download and Install: Obtain the extension from your preferred source, such as the VS Code Marketplace. If using a .vsix file, install it in Visual Studio Code by selecting "Install from VSIX..." from the Extensions menu.
Project Setup: Open a project in VS Code that includes a .vscode/launch.json file configured to debug a specific file using ${file}.
Node Process Method:
- Upon starting the server, copy the node binary path displayed in the startup popup.
- Update your configuration file (e.g., claude_desktop_config.json) with the path to mcp-debug.js:
```
{
  "mcpServers": {
    "debug": {
      "command": "node",
      "args": [
        "/path/to/mcp-debug.js"
      ]
    }
  }
}
```
- Start your MCP client, such as Claude Desktop, and ensure it is configured to use the newly set path.
SSE Method:
- Add the MCP server using the server URL, typically localhost
- Refresh your client if necessary and start the MCP client.

Once configured, you're ready to leverage AI's debugging capabilities to identify and resolve issues in your code efficiently.

Key Features of claude-debugs-for-you

Interactive Debugging: Engage with AI models like Claude to debug code interactively, providing a step-by-step evaluation of expressions and potential fixes.
Language Agnostic: Compatible with various programming languages, as long as the environment supports debugger consoles.
Versatile Configuration: Supports both node process-based and SSE-based methods, allowing flexibility in setup depending on your environment and needs.
MCP Integration: Utilizes the Model Context Protocol to securely connect AI systems with your development environment, ensuring a robust and secure debugging process.
Customizable: Easily configure ports and integration settings to suit your specific development setup.

With claude-debugs-for-you, developers can harness the power of AI to streamline their debugging process, making it a valuable tool in both learning environments and professional development workflows.

Badge

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

Download the extension from releases or VS Code Marketplace
Install the extension

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

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

This can be disabled in settings (e.g. once you've done it the first time or if you're using /sse)

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

Copy the path of the node binary to mcp-debug.js in the popup
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"

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

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

Add the MCP server using the server URL of " or whatever port you setup in settings.

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!

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 How do I set this up with Continue? / Show MCP Configuration Read the docs! 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.

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.
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!

How to Use

To use the claude-debugs-for-you, follow these steps:

Visit https://github.com/jasonjmcghee/claude-debugs-for-youhttps://github.com/jasonj...
Follow the setup instructions to create an account (if required)
Connect the MCP server to your Claude Desktop application
Start using claude-debugs-for-you capabilities within your Claude conversations

Additional Information

Created

January 17, 2025

Company

jasonjmcghee

Related MCP Servers

Start building your own MCP Server

Interested in creating your own MCP Server? Check out the official documentation and resources.

Learn More

Claude Debugs For You

What is claude-debugs-for-you

How to Use claude-debugs-for-you

Key Features of claude-debugs-for-you

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

Getting Started

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

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

You're ready to debug!

Contributing

Demo

Using Continue

Troubleshooting

Using Claude Desktop

Developing

Package

Run an Example

Configuration

Short list of ideas

How to Use

Additional Information

Created

Company

Related MCP Servers

MCP Fetch Node

Encoding Devops

Tavily Server

Start building your own MCP Server

Claude Debugs For You

What is claude-debugs-for-you

How to Use claude-debugs-for-you

Key Features of claude-debugs-for-you

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

Getting Started

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

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

You're ready to debug!

Contributing

Demo

Using Continue

Troubleshooting

Using Claude Desktop

Developing

Package

Run an Example

Configuration

Short list of ideas

How to Use

Additional Information

Created

Company

Related MCP Servers

MCP Fetch Node

Encoding Devops

Tavily Server

Start building your own MCP Server

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