home / mcp / mcp debugger mcp server

MCP Debugger MCP Server

Provides multi-language debugging tools and adapters via MCP to enable AI agents to debug Python, JavaScript, and Rust code.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "debugmcp-mcp-debugger": {
      "command": "node",
      "args": [
        "C:/path/to/mcp-debugger/dist/index.js",
        "--log-level",
        "debug",
        "--log-file",
        "C:/path/to/logs/debug-mcp-server.log"
      ]
    }
  }
}

mcp-debugger is an MCP server that exposes debugging operations as structured API calls to empower AI agents with multi-language debugging capabilities. It supports Python, JavaScript, and Rust debugging through language-specific adapters, enabling step-by-step debugging workflows that integrate with your AI workflows across languages.

How to use

You can use mcp-debugger with an MCP client to create and manage debugging sessions, set breakpoints, start and control debugging, and fetch variables and stack traces. Use it to orchestrate debugging across languages from your AI agent, with clear, machine-readable responses that you can parse and react to.

How to install

Prerequisites: you need Node.js installed on your system. You can verify with node -v and npm -v.

Step 1 — Install the MCP server

npm install -g @debugmcp/mcp-debugger

Step 2 — Run or use the CLI

You can run the server directly or interact via the command line to see available options.

mcp-debugger --help

Step 3 — Configure an MCP client to connect

Configure your MCP client to launch the server as a stdio process. Use the following example configuration to start a debugging session for a client that can communicate via JSON-RPC over stdio.

{
  "mcpServers": {
    "mcp-debugger": {
      "type": "stdio",
      "command": "node",
      "args": ["C:/path/to/mcp-debugger/dist/index.js", "--log-level", "debug", "--log-file", "C:/path/to/logs/debug-mcp-server.log"]
    }
  }
}

Step 4 — Verify installation with a quick session

Create a debug session, set breakpoints, and start debugging a script to verify the server is functioning correctly.

Available tools

create_debug_session

Create a new debugging session for a chosen language and session name.

list_debug_sessions

List all active debugging sessions.

set_breakpoint

Set a breakpoint in a specified file at a given line.

start_debugging

Start debugging a specified script within an active session.

get_stack_trace

Retrieve the current stack trace for the active frame.

get_scopes

Get variable scopes for a specific stack frame.

get_variables

Fetch variables within a given scope.

step_over

Step over the current line of code.

step_into

Step into a function call.

step_out

Step out of the current function.

continue_execution

Continue running the program until the next event or breakpoint.

close_debug_session

Close and clean up a debugging session.

pause_execution

Pause the currently running program.

evaluate_expression

Evaluate an arbitrary expression in the current context.

get_source_context

Get the source code context around the current execution point.