MCP Node.js Debugger

基本能力

产品定位

MCP Node.js Debugger 是一个专为 Node.js 开发者设计的调试工具，通过与 Cursor 或 Claude Code 集成，提供实时调试能力。

核心功能

1. 运行时调试：支持在 Node.js 运行时设置断点、检查变量状态和执行代码片段。
2. 集成开发环境支持：与 Cursor 和 Claude Code 无缝集成，提供直观的调试界面。
3. 错误诊断：帮助开发者快速定位和解决运行时错误。
4. 动态代码执行：允许在运行时执行特定代码片段以检查应用状态。

适用场景

1. 调试 Node.js 应用：适用于任何需要调试 Node.js 应用的场景。
2. 运行时错误诊断：特别适合诊断和解决运行时错误，如数据库连接问题。
3. 教学与学习：可用于教学环境中，帮助学生理解 Node.js 应用的运行时行为。

工具列表

1. Cursor：一个集成开发环境，支持通过 MCP Node.js Debugger 进行调试。
2. Claude Code：另一个支持 MCP Node.js Debugger 的开发工具，提供类似的调试功能。

常见问题解答

1. 如何连接 MongoDB Atlas？：确保 IP 地址已添加到 Atlas 集群的白名单中，并使用正确的凭据。
2. 如何设置断点？：通过 Cursor 或 Claude Code 的调试命令设置断点。
3. 如何检查变量状态？：使用 nodejs-debugger:nodejs_inspect 命令执行代码片段以检查变量状态。

使用教程

使用依赖

1. Node.js：确保已安装 Node.js，并支持 --inspect 标志。

安装教程

Cursor

1. 将以下配置添加到 ~/.cursor/mcp.json： json { "mcpServers": { "nodejs-debugger": { "command": "npx", "args": ["@hyperdrive-eng/mcp-nodejs-debugger"] } } }
2. 以调试模式运行 Node.js 应用： sh node --inspect {file.js}

Claude Code

1. 添加 MCP 服务器： sh claude mcp add nodejs-debugger npx @hyperdrive-eng/mcp-nodejs-debugger
2. 以调试模式运行 Node.js 应用： sh node --inspect {file.js}

调试方式

1. Cursor：在 Cursor 中直接请求调试 Node.js 服务器。
2. Claude Code：使用 /mcp 命令验证连接状态，并通过命令请求调试。 ```sh

   /mcp ⎿ MCP Server Status • nodejs-debugger: connected ```

3. 设置断点：通过 nodejs-debugger:set_breakpoint 命令设置断点。
4. 检查变量状态：使用 nodejs-debugger:nodejs_inspect 命令执行代码片段以检查变量状态。

许可证

None