MCP 服务器

MCP NodeJS Debugger

允许 Claude 通过设置断点、检查变量和单步调试代码来直接调试 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

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

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

在调试模式下运行 Node.js 服务器（即使用 --inspect 标志）
```
node --inspect {file.js}
```
要求 Cursor 在运行时调试您的 Node.js 服务器

Claude Code

添加到 Claude Code

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

启动 Claude Code

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

在调试模式下运行 Node.js 服务器（即使用 --inspect 标志）
```
# 在另一个终端
node --inspect {file.js}
```

要求 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

添加到 Claude Code

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

验证连接

> /mcp
  ⎿  MCP Server Status

     • nodejs-debugger: connected

从 Claude Code 中移除
```
claude remove nodejs-debugger
```

Cursor

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

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

验证连接:

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

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

示例

Cursor

运行这个简单的 Node.js 应用程序: github.com/mdn/express-locallibrary-tutorial:
```
node --inspect ./bin/www
```
要求 Cursor 设置一个断点
在 localhost:3000/catalog/book/create 创建一本书
观察 Cursor 捕获运行时状态

Claude Code

这是一个有 bug 的 Node.js 服务器:

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
}

Claude Code 在运行时调试 Node.js 服务器:

> 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 NodeJS Debugger

README

MCP Node.js 调试器

演示

Cursor

Claude Code

快速开始

Cursor

Claude Code

用法

Claude Code

Cursor

示例

Cursor

Claude Code

推荐服务器