Track MCP LogoTrack MCP
Track MCP LogoTrack MCP

The world's largest repository of Model Context Protocol servers. Discover, explore, and submit MCP tools.

Product

  • Categories
  • Top MCP
  • New & Updated
  • Submit MCP

Company

  • About

Legal

  • Privacy Policy
  • Terms of Service
  • Cookie Policy

ยฉ 2026 TrackMCP. All rights reserved.

Built with โค๏ธ by Krishna Goyal

    Mcp Nodejs Debugger

    ๐Ÿž MCP Node.js debugger JavaScript-based implementation.

    285 stars
    JavaScript
    Updated Oct 16, 2025
    debugger
    mcp
    mcp-server
    nodejs

    Table of Contents

    • Demo
    • Cursor
    • Claude Code
    • Quick start
    • Cursor
    • Claude Code
    • Usage
    • Claude Code
    • Cursor
    • Example
    • Cursor
    • Claude Code

    Table of Contents

    • Demo
    • Cursor
    • Claude Code
    • Quick start
    • Cursor
    • Claude Code
    • Usage
    • Claude Code
    • Cursor
    • Example
    • Cursor
    • Claude Code

    Documentation

    MCP Node.js Debugger

    An MCP server that gives Cursor or Claude Code access to Node.js at runtime to help you debug: [@hyperdrive-eng/mcp-nodejs-debugger](https://www.npmjs.com/package/@hyperdrive-eng/mcp-nodejs-debugger).

    Demo

    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

    Quick start

    Cursor

    1. Add to Cursor (~/.cursor/mcp.json)

    image

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

    1. Run a Node.js server in debug mode (i.e. with the --inspect flat)

    sh
    node --inspect {file.js}

    1. Ask Cursor to debug your Node.js server at runtime

    image

    Claude Code

    1. Add to Claude Code

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

    1. Start Claude Code

    sh
    claude
        โ•ญโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ•ฎ
        โ”‚ โœป Welcome to Claude Code research preview!            โ”‚
        โ”‚                                                       โ”‚
        โ”‚   /help for help                                      โ”‚
        โ”‚                                                       โ”‚
        โ”‚   Found 1 MCP server (use /mcp for status)            โ”‚
        โ•ฐโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ•ฏ

    2. Run a Node.js server in debug mode (i.e. with the --inspect flat)

    sh
    # In another terminal
        node --inspect {file.js}

    3. Ask Claude Code to debug your Node.js server at runtime

    sh
    > 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.

    Usage

    Claude Code

    1. Add to Claude Code

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

    1. Verify connection

    sh
    > /mcp
          โŽฟ  MCP Server Status
    
             โ€ข nodejs-debugger: connected

    1. Remove from Claude Code

    sh
    claude remove nodejs-debugger

    Cursor

    1. Add to Cursor (~/.cursor/mcp.json)

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

    1. Verify connection:

    image

    1. Remove from Cursor (~/.cursor/mcp.json):

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

    Example

    Cursor

    1. Run this simple Node.js app: github.com/mdn/express-locallibrary-tutorial:

    sh
    node --inspect ./bin/www

    1. Ask Cursor to set a breakpoint

    image

    image

    2. Create a book at [localhost:3000/catalog/book/create](http://localhost:3000/catalog/book/create)

    image

    1. Watch Cursor capture runtime state

    image

    Claude Code

    1. Here is a buggy Node.js server:

    code
    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
        }

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

    sh
    > 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?

    Similar MCP

    Based on tags & features

    • DA

      Davinci Resolve Mcp

      Pythonยท
      327
    • AW

      Aws Mcp Server

      Pythonยท
      165
    • BI

      Biomcp

      Pythonยท
      327
    • MC

      Mcpjungle

      Goยท
      617

    Trending MCP

    Most active this week

    • PL

      Playwright Mcp

      TypeScriptยท
      22.1k
    • SE

      Serena

      Pythonยท
      14.5k
    • MC

      Mcp Playwright

      TypeScriptยท
      4.9k
    • MC

      Mcp Server Cloudflare

      TypeScriptยท
      3.0k
    View All MCP Servers

    Similar MCP

    Based on tags & features

    • DA

      Davinci Resolve Mcp

      Pythonยท
      327
    • AW

      Aws Mcp Server

      Pythonยท
      165
    • BI

      Biomcp

      Pythonยท
      327
    • MC

      Mcpjungle

      Goยท
      617

    Trending MCP

    Most active this week

    • PL

      Playwright Mcp

      TypeScriptยท
      22.1k
    • SE

      Serena

      Pythonยท
      14.5k
    • MC

      Mcp Playwright

      TypeScriptยท
      4.9k
    • MC

      Mcp Server Cloudflare

      TypeScriptยท
      3.0k