mcp-debugger is a headless MCP server that lets AI agents drive real debuggers — breakpoints, stepping, live variables — in CI runners, containers, Kubernetes pods, and cloud sandboxes. Seven languages. No IDE anywhere in the loop.
$ npx @debugmcp/mcp-debugger stdio
where IDEs can't go
An IDE debugger needs an IDE, a screen, and a human at the keyboard. Agents work where none of those exist — and that's exactly where the interesting failures live.
On test failure, the agent sets real breakpoints in the failing path, inspects live values, and posts the root cause as a PR comment.
- uses: debugmcp/mcp-debugger/.github/actions/debug-failing-test@mainThe debug-failing-test action →
Attach to a misbehaving pod through a port-forward, inspect the state your logs never captured, detach. No redeploy, no new logging.
$ kubectl port-forward deploy/checkout 5678:5678Just-in-time diagnostics tutorial →
Claude Code, Copilot, Cursor, and headless harnesses connect over stdio or HTTP. A debug session becomes structured tool calls an agent can reason about.
$ claude mcp add-json mcp-debugger …Client setup →
languages
Every adapter drives the language's own production debugger through the Debug Adapter Protocol — the same engines your IDE would use, without the IDE.
| Language | Engine | Launch | Attach | Remote attach | Notable |
|---|---|---|---|---|---|
| Python | debugpy | ✓ | ✓ | ✓ | logpoints, exception breakpoints |
| JavaScript / TypeScript | js-debug | ✓ | ✓ | — | VS Code's engine, TS auto-detection |
| Ruby | rdbg | ✓ | ✓ | ✓ | attach into containers & pods |
| Rust | CodeLLDB | ✓ | — | — | Cargo-aware launch, logpoints |
| Go | Delve | ✓ | — | — | native DAP, logpoints |
| Java | JDI bridge | ✓ | ✓ | ✓ | JDWP attach, class hot-swap |
| .NET / C# | netcoredbg | ✓ | ✓ | — | PID attach, portable PDB handling |
Plus a mock adapter for testing agent integrations without any toolchain installed.
choosing a debug server
Microsoft's DebugMCP exposes VS Code's debugger over MCP and is a good choice when your agent works inside a running VS Code. The projects make different structural trade-offs:
| mcp-debugger | microsoft/DebugMCP | |
|---|---|---|
| Runs headless (CI, containers, k8s, cloud) | ✓ standalone process | requires running VS Code |
| Transports | stdio + Streamable HTTP | HTTP (localhost) |
| Distribution | npx, npm, Docker | VS Code Marketplace |
| Remote attach without an IDE | ✓ debugpy / rdbg / JDWP | — |
| Per-session process isolation | ✓ | shares the VS Code instance |
| Java hot-swap | ✓ | — |
| In-IDE debugging UX beside the agent | planned | ✓ native |
| C/C++, PHP | — | ✓ via VS Code extensions |
If your agent runs in a terminal, a pipeline, or a cloud sandbox — or needs to reach a process on another machine — you want mcp-debugger.
agent skill
mcp-debugger ships an agent skill: when to reach for the debugger, the session golden path, root-cause bisection discipline, and the per-language quirks we learned so your agent doesn't have to. The server also serves condensed guidance in-band via MCP instructions and a debugging-workflow prompt.
$ npx skills add debugmcp/mcp-debugger
who stands behind this
mcp-debugger is stewarded by Sycamore LLC and led by John Franklin. AI agents write most of the code; a human maintainer makes every merge, release, and security decision. The project is MIT-licensed — the grant doesn't depend on the steward.
npm audit signatures @debugmcp/mcp-debugger