home / mcp / claude debug mcp server

Claude Debug MCP Server

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

Installation
Add the following to your MCP client configuration file.

Configuration

View docs
{
  "mcpServers": {
    "jasonjmcghee-claude-debugs-for-you": {
      "command": "node",
      "args": [
        "/path/to/mcp-debug.js"
      ]
    }
  }
}

You can enable interactive debugging with Claude by running a local MCP server that the debugging client connects to. This MCP server configuration lets Claude debug and evaluate expressions in your code, across languages, as long as your debugger supports a console-based interface and a valid launch configuration.

How to use

You will connect your MCP client to a local server that exposes a debugging endpoint. Start by configuring a stdio-based MCP server and point your client at it. You can then start Claude to begin interactive debugging.

Set up the MCP server configuration to run locally using Node and your MCP debug script. The following configuration defines a server named debug that launches a Node process running your MCP debug script. Update the path to your actual script before starting.

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

Starting Claude after configuring

Open Claude Desktop or your MCP client and ensure the server is started. You may need to restart Claude if it was already running. You will see a status indicator showing whether the server is running properly.

If you use other clients that support MCP, you can connect to the same stdio server endpoint by using the configured command and arguments.

Alternate connection via sse

If your client supports server-sent events (SSE), you can connect by the SSE address. The guidance mentions a typical local SSE URL like http://localhost:4711/sse, adjusted to your setup. You would use this URL in your client configuration where required.

You're ready to debug!

With the MCP server running, you can open a project in your MCP client, attach the debugger, and begin stepping through code. Use breakpoints and evaluation of expressions to locate issues, just as you would with any standard debugger.

Troubleshooting and practical tips

If you start multiple IDE windows, Claude Debugs For You can be handed between windows. If autostart is undesired, you can disable it and manually start the server from the status menu.