Node.js 调试器 MCP 服务器

提供带有进程管理功能的 Node.js 调试能力的 MCP 服务器，适用于 AI 代理。

<a href="https://glama.ai/mcp/servers/@qckfx/node-debugger-mcp"> <img width="380" height="200" src="https://gips0.baidu.com/it/u=1693504038,1194465275&fm=3081&app=3081&f=PNG?w=760&h=400" alt="Node.js 调试器 MCP 服务器" /> </a>

特性

• 进程管理：启用调试功能启动/停止 Node.js 进程
• 调试工具：设置断点、逐步执行代码、评估表达式
• 检查器集成：连接到 Node.js 检查器 API
• 适合 AI 代理：专为长时间运行的调试会话设计

安装

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 - 逐步执行代码（下一步/继续/跳出）
• pause_execution - 手动暂停正在运行的进程
• evaluate_expression - 在调试上下文中评估表达式

资源

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

示例用法

1. 启动一个 Node.js 进程：

   使用 start_node_process 工具，脚本："example-app.js"
   

2. 连接调试器：

   使用 attach_debugger 工具，端口号从步骤 1 返回
   

3. 设置断点并调试：

   # 使用完整的文件 URL 设置断点
   使用 set_breakpoint 工具，参数：
   - 文件："file:///absolute/path/to/example-app.js"
   - 行：5
   
   # 控制执行
   使用 step_debug 工具，动作："continue"
   

主要特性

• 自动开始暂停：使用 --inspect-brk 标志在第一行暂停
• 完整的 Chrome 开发者工具协议：真正的调试，而非模拟
• 可靠的断点：使用 file:// URL 以确保一致的断点命中
• 进程管理：跟踪和管理多个调试会话

测试

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

node --inspect=9229 example-app.js

然后使用 MCP 工具对其进行调试！

调试 MCP 服务器

npm run inspector