Node Debugger

Node.js 调试器 MCP 服务

一个提供 Node.js 调试功能并支持进程管理的 MCP 服务，适用于 AI Agent。

功能

• 进程管理：启动或停止启用调试功能的 Node.js 进程
• 调试工具：设置断点、单步执行代码、求值表达式
• Inspector 集成：连接到 Node.js Inspector API
• 适用于 AI Agent：专为长时间运行的调试会话设计

安装

1. 构建服务：

   npm install
   npm run build
   

2. 用于特定项目：本项目已配置 .mcp.json 文件

3. 用于全局用户：添加到全局 Claude Code 配置：

   claude mcp add --scope user debugger-mcp node /absolute/path/to/debugger-mcp/build/index.js
   

4. 用于全局使用：将 .mcp.json 复制到你的项目，或添加到全局配置中

在 Claude Code 中使用

配置完成后，你就可以在 Claude Code 中使用以下工具：

进程管理

• start_node_process - 启动 Node.js 脚本并启用调试功能
• kill_process - 按 PID 终止进程
• list_processes - 显示所有受管理的进程

调试

• attach_debugger - 连接到调试端口
• set_breakpoint - 设置断点，可选添加条件
  • 重要：使用完整的 file:// URL，确保可靠地命中断点
  • 示例：file:///Users/you/project/script.js
• step_debug - 单步执行代码（next/step/continue/out）
• pause_execution - 手动暂停正在运行的进程
• evaluate_expression - 在调试上下文中求值表达式

资源

• debug://session - 当前调试会话状态
• debug://processes - 受管理进程列表

使用示例

1. 启动 Node.js 进程：

   Use the start_node_process tool with script: "example-app.js"
   

2. 连接调试器：

   Use attach_debugger tool with the port returned from step 1
   

3. 设置断点并调试：

   # Set a breakpoint using full file URL
   Use set_breakpoint tool with:
   - file: "file:///absolute/path/to/example-app.js"
   - line: 5
   
   # Control execution
   Use step_debug tool with action: "continue"
   

主要功能

• 启动时自动暂停：使用 --inspect-brk 标志，在第一行暂停
• 完整的 Chrome DevTools Protocol：真实调试，并非模拟
• 可靠的断点：使用 file:// URL，确保稳定命中断点
• 进程管理：跟踪并管理多个调试会话

测试

使用附带的示例应用进行测试：

node --inspect=9229 example-app.js

然后使用 MCP 工具调试它！

调试 MCP 服务

npm run inspector