mcp-debugger：让 AI Agent 真正学会单步调试的 MCP 工具

AI 写代码已经很强了，但调试这块一直是个老大难——你见过几个 AI Coding Agent 能真正帮你设断点、单步走、查变量的？大多数只能靠打日志、靠猜。

mcp-debugger 就是来解决这个问题的。

这是一个基于 MCP（Model Context Protocol）的调试服务器，把传统调试能力以结构化工具调用的形式暴露给 AI Agent。说人话：装上它，你的 Claude Code、Codex、Cursor 这些工具就能真正”看见”运行中的程序了。

支持 7 种主流语言

Python、JavaScript/TypeScript、Ruby、Rust、Go、Java、.NET，基本覆盖了大多数开发场景。它底层走的是 Debug Adapter Protocol（DAP），调用各语言的原生调试器，所以调试能力是完整的，不是模拟的。

真正无 IDE 的 Headless 调试

这是它和微软 DebugMCP 最大的区别。DebugMCP 需要一个正在运行的 VS Code 实例，但 mcp-debugger 是纯独立进程，通过 stdio 或 Streamable HTTP 通信，CI 容器里能跑、Kubernetes Pod 里能跑、SSH 远程机器上也能跑。

换句话说：哪里都能跑，IDE 不需要。

几个开发者会感兴趣的细节

• 每会话独立进程隔离，不会互相干扰
• Java 热交换（redefine_classes）支持，生产级别能力
• 调试对象输出可以作为 MCP 资源订阅，Agent 能实时感知程序状态
• 支持远程 attach，不需要在目标机器装完整 IDE

怎么装

npm 全局装：npm install -g @debugmcp/mcp-debugger
或者 Docker：docker pull debugmcp/mcp-debugger

然后在你的 Claude Code/Codex 配置文件里加一个 MCP Server 入口就行。官方给了 .mcp.json.example 示例，改两行就跑起来。

如果你经常用 AI 编程工具同时又要维护复杂项目的调试流程，这个 Skill 值得装上试试。

GitHub：https://github.com/debugmcp/mcp-debugger

GitHub: https://github.com/debugmcp/mcp-debugger