NodeJS调试器

@hyperdrive-eng/mcp-nodejs-debugger
1 Stars 116 次浏览 hyperdrive-eng 更新于 2026-08-23

允许克劳德通过设置断点、检查变量和逐步执行代码来直接调试 NodeJS 服务器。

开发者工具
该服务暂未提供标准配置，请参考 README 手动接入

服务介绍

MCP Node.js 调试器

一个MCP服务器，它在运行时为Cursor或Claude Code提供对Node.js的访问权限，以帮助您调试: @hyperdrive-eng/mcp-nodejs-debugger。

演示

Cursor

https://github.com/user-attachments/assets/c193a17e-b0e6-4c51-82aa-7f3f0de17e1a

Claude Code

https://github.com/user-attachments/assets/adb7321b-3a6a-459b-a5c9-df365710d4d8

快速开始

Cursor

  1. 添加到Cursor (~/.cursor/mcp.json)

    image

    + {
+   "mcpServers": {
+   "nodejs-debugger": {
+      "command": "npx",
+       "args": ["@hyperdrive-eng/mcp-nodejs-debugger"]
+     }
+   }
+ }

  2. 以调试模式（即使用--inspect标志）运行Node.js服务器

    node --inspect {file.js}

  3. 请求Cursor在运行时调试您的Node.js服务器

    image

Claude Code

  1. 添加到Claude Code

    claude mcp add nodejs-debugger npx @hyperdrive-eng/mcp-nodejs-debugger

  2. 启动Claude Code

    claude
╭───────────────────────────────────────────────────────╮
│ ✻ Welcome to Claude Code research preview!            │
│                                                       │
│   /help for help                                      │
│                                                       │
│   Found 1 MCP server (use /mcp for status)            │
╰───────────────────────────────────────────────────────╯

  3. 以调试模式（即使用--inspect标志）运行Node.js服务器

    # 在另一个终端中
node --inspect {file.js}

  4. 请求Claude Code在运行时调试您的Node.js服务器

    > I'm getting a runtime error in Node.js 

  {YOUR_RUNTIME_ERROR}

  Please help me debug this error at runtime using the nodejs-debugger mcp.

使用方法

Claude Code

  1. 添加到Claude Code

    claude mcp add nodejs-debugger npx mcp-nodejs-debugger

  2. 验证连接

    > /mcp
  ⎿  MCP Server Status

     • nodejs-debugger: connected

  3. 从Claude Code移除

    claude remove nodejs-debugger

Cursor

  1. 添加到 Cursor (~/.cursor/mcp.json)

    + {
+   "mcpServers": {
+   "nodejs-debugger": {
+      "command": "npx",
+       "args": ["@hyperdrive-eng/mcp-nodejs-debugger"]
+     }
+   }
+ }

  2. 验证连接：

    image

  3. 从 Cursor 中移除 (~/.cursor/mcp.json)：

    - {
-   "mcpServers": {
-   "nodejs-debugger": {
-      "command": "npx",
-       "args": ["@hyperdrive-eng/mcp-nodejs-debugger"]
-     }
-   }
- }

示例

Cursor

  1. 运行这个简单的 Node.js 应用程序：github.com/mdn/express-locallibrary-tutorial：

    node --inspect ./bin/www

  2. 要求 Cursor 设置一个断点

    image

    image

  3. 在 localhost:3000/catalog/book/create 创建一本书

    image

  4. 观察 Cursor 捕获运行时状态

    image

Claude Code

  1. Here is a buggy Node.js server:

    node --inspect index.js

Debugger listening on ws://127.0.0.1:9229/2862f5a2-8618-4516-8429-1248b397e9b4

#######################
## THE RUNTIME ERROR ##
#######################
MongooseServerSelectionError: Could not connect to any servers in your MongoDB Atlas cluster. One common reason is that you're trying to access the database from an IP that isn't whitelisted. Make sure your current IP address is on your Atlas cluster's IP whitelist: https://www.mongodb.com/docs/atlas/security-whitelist/
    at _handleConnectionErrors (/Users/arthur/Documents/thirdparties/mdn/express-locallibrary-tutorial/node_modules/mongoose/lib/connection.js:1110:11)
    at NativeConnection.openUri (/Users/arthur/Documents/thirdparties/mdn/express-locallibrary-tutorial/node_modules/mongoose/lib/connection.js:1041:11)
    at async main (/Users/arthur/Documents/thirdparties/mdn/express-locallibrary-tutorial/app.js:35:3) {
  reason: TopologyDescription {
    type: 'ReplicaSetNoPrimary',
    servers: Map(3) {
      'ac-8e6hgk7-shard-00-01.cojoign.mongodb.net:27017' => [ServerDescription],
      'ac-8e6hgk7-shard-00-02.cojoign.mongodb.net:27017' => [ServerDescription],
      'ac-8e6hgk7-shard-00-00.cojoign.mongodb.net:27017' => [ServerDescription]
    },
    stale: false,
    compatible: true,
    heartbeatFrequencyMS: 10000,
    localThresholdMS: 15,
    setName: 'atlas-5syy8t-shard-0',
    maxElectionId: null,
    maxSetVersion: null,
    commonWireVersion: 0,
    logicalSessionTimeoutMinutes: null
  },
  code: undefined
}

  2. Claude Code debugs the Node.js server at runtime:

    > I'm getting a runtime error connecting to mongoose. Please help me debug by checking the value of 
  the mongodb configs at runtime using the nodejs-debugger mcp.

  ⏺ I'll help you debug the mongoose connection issue using the Node.js debugger. Let's first understand where the
  MongoDB connection is configured.

  ⏺ Search(pattern: "**/*.js")…
    ⎿  Found 100 files

  ⏺ Let's set a breakpoint at the mongoose connection point and continue:

  ⏺ nodejs-debugger:set_breakpoint (MCP)(file:                                                                         …
        "/Users/arthur/Documents/thirdparties/mdn/express-locallibrary-tutorial/app.js",
         line: 35)
    ⎿  Breakpoint set successfully. ID:
       2:34:0:file:///Users/arthur/Documents/thirdparties/mdn/express-locallibrary-tutorial/app\.js

  ⏺ Let's list all our breakpoints:

  ⏺ nodejs-debugger:list_breakpoints (MCP)
    ⎿  [
         {
           "file": "/Users/arthur/Documents/thirdparties/mdn/express-locallibrary-tutorial/app.js",
           "line": 35,
           "id": "2:34:0:file:///Users/arthur/Documents/thirdparties/mdn/express-locallibrary-tutorial/app\\.js"
         }
       ]

  ⏺ Let's try to execute a specific piece of code to check the connection variables:

  ⏺ nodejs-debugger:nodejs_inspect (MCP)(js_code: "// Get the mongoose module and inspect connection\nconst mongoose = …
                                        require('mongoose');\nconsole.log('Current mongoose version:',
                                        mongoose.version);\nconsole.log('Current mongoose connection state:',
                                        mongoose.connection.readyState);\n// Log connection string safely (without
                                        password)\nconst connectionString = process.env.MONGODB_URI || \n
                                        \"mongodb+srv://cooluser:coolpassword@cluster0.cojoign.mongodb.net/local_library?retryWr
                                        ites=true&w=majority&appName=Cluster0\";\nconsole.log('Connection string
                                        (masked):', connectionString.replace(/(?<=mongodb\\+srv:\\/\\/\\w+:)(.+?)(?=@)/,
                                         '*****'));")

    ⎿  Console output:
       [log] Current mongoose version: 8.9.5
       [log] Current mongoose connection state: 0
       [log] Connection string (masked): mongodb+srv://cooluser:coolpassword@cluster0.cojoign.mongodb.net/local_library?retryWri
       tes=true&w=majority&appName=Cluster0

  ⏺ The runtime error you're seeing in your application is related to MongoDB
    Atlas connection issues. Based on your error message, the problem is:

    1. You're using placeholder credentials ("cooluser:coolpassword")

    To fix this, you have two options:

    1. Use a local MongoDB instance by changing line 29-30 in app.js to:
    const dev_db_url = "mongodb://127.0.0.1:27017/local_library";
    2. Or correctly set up MongoDB Atlas:
      - Log into Atlas at https://cloud.mongodb.com
      - Go to Network Access and add your current IP to whitelist
      - Create proper database credentials
      - Update the connection string with real credentials

    Which option would you like to proceed with?
查看源码 项目主页

相关 MCP 服务

LeetCode(力扣)
jinzcdev/leetcode-mcp-server
MCP 服务器实现 LeetCode API 集成，支持自动化获取编程题库、用户数据和竞赛信息。
可视化图表-MCP-Server
antvis/mcp-server-chart
这是一个基于AntV的模型上下文协议服务器，用于生成图表。它支持超过20种类型的图表，并且可以与多种桌面应用程序和平台一起使用。
微软Playwright
@microsoft/playwright-mcp
一种模型上下文协议服务器，它使大型语言模型能够通过结构化的可访问性快照与网页交互，而无需使用视觉模型或截图。
MCP上下文模型文档
@upstash/context7-mcp
一种模型上下文协议服务器，它从库中直接获取最新、特定版本的文档和代码示例并将其引入LLM提示中，帮助开发人员在无需过时或虚构信息的情况下获得准确的答案。