debugger-mcp 0.1.0

MCP server exposing debugger tools for AI clients (Node.js and Python)

debugger-mcp

MCP server that exposes debugger tools to AI clients (Cursor, Claude Code, etc.): launch, breakpoints, continue, step, evaluate, stack, variables, probe, stop. Supports Node.js (CDP) and Python (DAP). The debugger runtime (top-coder-ai-skills-debugger) is included as a dependency — no separate installation.

Install

One install is enough (the debugger library is pulled in automatically):

pip install debugger-mcp
# or
uv add debugger-mcp
# or
poetry add debugger-mcp

Requires: Python ≥3.11. Nothing else to install.

Global

Use without adding the package to a project:

• pipx (install once, run from anywhere):

  pipx install debugger-mcp
  debugger-mcp
  

  Then in MCP config use "command": "debugger-mcp" (pipx puts it on PATH).

• uvx (run on demand, no install — like npx):

  uvx debugger-mcp
  

  In MCP config: "command": "uvx", "args": ["debugger-mcp"].

Run

Stdio transport (e.g. for Cursor MCP):

python -m debugger_mcp

Configure in your MCP client (e.g. Cursor) as:

{
  "mcpServers": {
    "debugger": {
      "command": "python3",
      "args": ["-m", "debugger_mcp"]
    }
  }
}

Ensure the python3 (or uv run) environment has debugger-mcp installed so that python -m debugger_mcp works.

Tools

Tool	Description
debug_launch	Start debugging a program (program, language)
debug_breakpoint	Set breakpoint (file, line)
debug_continue	Resume until next breakpoint or exit
debug_step	Step over or step in
debug_evaluate	Evaluate expression in current frame
debug_stack	Get call stack
debug_variables	Get local variables
debug_probe	One-shot: run to line, dump state, stop
debug_stop	End the debug session

See the repo and ARCHITECTURE.md for protocol and usage details.