debugmcp avatar

mcp-debugger

debugmcp/mcp-debugger

Connects AI agents to debugpy, js-debug, CodeLLDB, Delve, JDI, and netcoredbg through the Debug Adapter Protocol. Exposes operations like create_debug_session, set_breakpoint, step_over, and get_variables as MCP tools with structured JSON responses. Ships with 1266+ tests and runs via npx with zero runtime dependencies. Reach for this when you want Claude to step through Python, JavaScript, Rust, Go, Java, or .NET code instead of just reading it. The mock adapter lets you test integration logic without spinning up actual debuggers. Available as npm package or Docker image, though Rust debugging needs local deployment to access your toolchain.

GitHub stars
186
tools
29
transport
STDIO
last updated
Oct 31, 2026

Tools

29 tools

Public tool metadata for what this MCP can expose to an agent.

create_debug_sessionCreate a new debugging session

Create a new debugging session

No parameter schema in public metadata yet.

list_debug_sessionsList all active sessions

List all active sessions

No parameter schema in public metadata yet.

list_supported_languagesShow available language adapters

Show available language adapters

No parameter schema in public metadata yet.

set_breakpointSet a breakpoint in a file

Set a breakpoint in a file

No parameter schema in public metadata yet.

list_breakpointsList a session's breakpoints with verified state

List a session's breakpoints with verified state

No parameter schema in public metadata yet.

remove_breakpointRemove a breakpoint by id or file+line

Remove a breakpoint by id or file+line

No parameter schema in public metadata yet.

clear_breakpointsRemove all breakpoints (optionally per file)

Remove all breakpoints (optionally per file)

No parameter schema in public metadata yet.

start_debuggingStart debugging a script — or a failing test in one call (`testRunner: "pytest"`)

Start debugging a script — or a failing test in one call (`testRunner: "pytest"`)

No parameter schema in public metadata yet.

restart_debuggingRelaunch with the same config, breakpoints re-applied

Relaunch with the same config, breakpoints re-applied

No parameter schema in public metadata yet.

attach_to_processAttach debugger to a running process

Attach debugger to a running process

No parameter schema in public metadata yet.

detach_from_processDetach debugger from a process

Detach debugger from a process

No parameter schema in public metadata yet.

expose_sessionOpen a read-only DAP mirror endpoint so an IDE can attach and inspect

Open a read-only DAP mirror endpoint so an IDE can attach and inspect

No parameter schema in public metadata yet.

unexpose_sessionClose the mirror endpoint and disconnect IDE clients

Close the mirror endpoint and disconnect IDE clients

No parameter schema in public metadata yet.

get_stack_traceGet the current stack trace

Get the current stack trace

No parameter schema in public metadata yet.

list_threadsList all threads in the debug session

List all threads in the debug session

No parameter schema in public metadata yet.

get_scopesGet variable scopes for a frame

Get variable scopes for a frame

No parameter schema in public metadata yet.

get_variablesGet variables in a scope

Get variables in a scope

No parameter schema in public metadata yet.

get_local_variablesGet local variables in current frame

Get local variables in current frame

No parameter schema in public metadata yet.

step_overStep over the current line

Step over the current line

No parameter schema in public metadata yet.

step_intoStep into a function

Step into a function

No parameter schema in public metadata yet.

step_outStep out of a function

Step out of a function

No parameter schema in public metadata yet.

continue_executionContinue running

Continue running

No parameter schema in public metadata yet.

wait_for_stopBlock until the session next pauses or ends

Block until the session next pauses or ends

No parameter schema in public metadata yet.

pause_executionPause running execution

Pause running execution

No parameter schema in public metadata yet.

evaluate_expressionEvaluate expressions in debug context

Evaluate expressions in debug context

No parameter schema in public metadata yet.

get_source_contextGet source code context

Get source code context

No parameter schema in public metadata yet.

get_outputRead captured debuggee output (stdout/stderr)

Read captured debuggee output (stdout/stderr)

No parameter schema in public metadata yet.

close_debug_sessionClose a session

Close a session

No parameter schema in public metadata yet.

hot_reloadApply changed code to the running program and keep its state — Flutter hot reload, Java class redefinition (`redefine_classes` is a deprecated alias)

Apply changed code to the running program and keep its state — Flutter hot reload, Java class redefinition (`redefine_classes` is a deprecated alias)

No parameter schema in public metadata yet.

Sponsors

Readme

mcp-debugger

MCP Debugger Logo - A stylized circuit board with debug breakpoints

A headless, agentic debugger over MCP — let your AI agents debug running programs in ten languages.

CI codecov npm version Docker Pulls License: MIT OpenSSF Scorecard OpenSSF Best Practices


View the full README on GitHub

Details

Repository
github.com/debugmcp/mcp-debugger
Website
debugmcp.io
Package
@debugmcp/mcp-debugger
Transport
STDIO
Registry
MCP registry, active