用途：这是一个 MCP（模型上下文协议）服务器，通过 Chrome DevTools Protocol 暴露完整的 Node.js 调试能力，使 AI 助手能够以编程方式设置断点、单步执行、检查变量、求值表达式、分析调用栈并处理源码映射。
主要能力：会话管理（以 --inspect-brk=0 启动/停止 Node.js 进程）；断点（行断点、条件断点、日志点、异常暂停）；执行控制（恢复、单步跳过/进入/跳出、继续到指定位置、重启帧）；检查（作用域 locals/closures/this、深入对象属性）；求值（在暂停帧中执行 JavaScript 表达式）；控制台捕获；源码映射（支持 TypeScript 及转译代码调试）；脚本管理（列出已加载脚本、获取源码、黑盒模式）。
使用方式：安装 npm install devtools-debugger-mcp 或全局安装 npm install -g devtools-debugger-mcp。在 MCP 客户端配置中添加服务器，例如 Claude Desktop 的 claude_desktop_config.json 中指定 command 为 node、args 为 dist/index.js 路径，或全局安装后 command 直接写 devtools-debugger-mcp。核心流程为 start_node_debug 启动会话、set_breakpoint 设断点、resume_execution 与 step_over/step_into/step_out 控制执行、inspect_scopes 与 evaluate_expression 检查状态、stop_debug_session 结束。输出格式可通过 set_output_format 设为 text、json 或 both。
适用场景：调试 Express API、异步 async/await 代码、TypeScript 项目，以及需要 AI 自动定位和分析 Node.js 运行时问题的场景。
限制：filePath 必须使用绝对路径，相对路径不会自动解析；行号基于 1；源码映射需生成 .map 文件；控制台缓冲区每次读取后清空；调试结束应显式调用 stop_debug_session 以避免残留进程。许可证为 MIT。