mcp-debugger
mcp-debugger is an MCP server that adds developer tools to AI assistants such as Claude Desktop, Claude Code and Cursor. Step-through debugging for AI agents: breakpoints, stepping and live variables in ten languages. It has 191 GitHub stars, is released under the MIT license and runs locally with npx -y @debugmcp/mcp-debugger.
github.com/debugmcp/mcp-debugger (opens in a new tab)
Data as of from the GitHub API and the official MCP registry; description from the project's repository. Report an error
Install mcp-debugger
Generated from the server's MCP registry entry. Replace your-value with your own values.
Claude Desktop
{
"mcpServers": {
"mcp-debugger": {
"command": "npx",
"args": [
"-y",
"@debugmcp/mcp-debugger"
]
}
}
}Settings > Developer > Edit Config. macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\. Restart Claude Desktop afterwards.
Claude Code
claude mcp add --transport stdio mcp-debugger -- npx -y @debugmcp/mcp-debuggerCursor
{
"mcpServers": {
"mcp-debugger": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@debugmcp/mcp-debugger"
]
}
}
}Project file; use ~/.cursor/mcp.json to enable it in every project.
VS Code
{
"servers": {
"mcp-debugger": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@debugmcp/mcp-debugger"
]
}
}
}Config formats checked against the official docs on Oct 7, 2026: modelcontextprotocol.io (opens in a new tab), code.claude.com (opens in a new tab), cursor.com (opens in a new tab), code.visualstudio.com (opens in a new tab).
Tools (29)
Parsed from the Tools section of the README; check the repository for the current list.
create_debug_sessionCreate a new debugging session
list_debug_sessionsList all active sessions
list_supported_languagesShow available language adapters
set_breakpointSet a breakpoint in a file
list_breakpointsList a session's breakpoints with verified state
remove_breakpointRemove a breakpoint by id or file+line
clear_breakpointsRemove all breakpoints (optionally per file)
start_debuggingStart debugging a script — or a failing test in one call (testRunner: "pytest")
restart_debuggingRelaunch with the same config, breakpoints re-applied
attach_to_processAttach debugger to a running process
detach_from_processDetach debugger from a process
expose_sessionOpen a read-only DAP mirror endpoint so an IDE can attach and inspect
unexpose_sessionClose the mirror endpoint and disconnect IDE clients
get_stack_traceGet the current stack trace
list_threadsList all threads in the debug session
get_scopesGet variable scopes for a frame
get_variablesGet variables in a scope
get_local_variablesGet local variables in current frame
step_overStep over the current line
step_intoStep into a function
step_outStep out of a function
continue_executionContinue running
wait_for_stopBlock until the session next pauses or ends
pause_executionPause running execution
evaluate_expressionEvaluate expressions in debug context
get_source_contextGet source code context
get_outputRead captured debuggee output (stdout/stderr)
close_debug_sessionClose a session
hot_reloadApply changed code to the running program and keep its state — Flutter hot reload, Java class redefinition…
About mcp-debugger
A headless, agentic debugger over MCP — let your AI agents debug running programs in ten languages. mcp-debugger is a Model Context Protocol (MCP) server that exposes step-through debugging as structured tool calls. It lets AI agents set breakpoints, inspect variables, evaluate expressions, and step through running programs across ten languages — driving real language debuggers through the Debug Adapter Protocol (DAP).
Similar MCP servers
More developer tools MCP servers
Sanity
sanity-io/agent-toolkit
Gives AI agents direct access to your Sanity projects and guidance for working with them.
Maintained · last commit Oct 27, 2026
OfficialDeveloper toolsJavaScriptGodot MCP
satelliteoflove/godot-mcp
Agent-driven Godot playtesting: editor control, input injection, game-time stepping, live state.
Active · last commit Nov 11, 2026
Developer toolsGDScriptGitwand
devlint/GitWand
Auto-resolves Git merge conflicts so agents only touch the complex hunks.
Active · last commit Nov 12, 2026
Developer toolsTypeScriptSandBase
sandbaseai/cli
Connect MCP clients to 2,000+ AI models without managing provider API keys.
Active · last commit Nov 11, 2026
Developer toolsTypeScriptpaper-preflight
amos689/paper-preflight
Checks every LaTeX reference against Crossref, dblp, arXiv, DataCite, PubMed and OpenAlex.
Too new to judge · created Oct 3, 2026
Developer toolsPythonzanadir
MustacheCase/zanadir
Find what a repository's CI is missing, and which security checks cannot fail the build.
Active · last commit Nov 16, 2026
Developer toolsGo
How do I install the mcp-debugger MCP server?
Add the command npx -y @debugmcp/mcp-debugger to your MCP client: put it in claude_desktop_config.json for Claude Desktop, run claude mcp add for Claude Code, or add it to .cursor/mcp.json (Cursor) or .vscode/mcp.json (VS Code). The snippets on this page are ready to paste.
Is mcp-debugger free?
The server is open source under the MIT license, so running it is free. It does not declare any required API key.
Is mcp-debugger actively maintained?
The most recent commit was on Nov 15, 2026. The latest release is v0.26.0, published Oct 31, 2026. appsgit only lists MCP servers with a commit in the last six months.