Related MCP Server Resources

Explore more AI models, providers, and integration options:

  • Explore AI Models
  • Explore AI Providers
  • Explore MCP Servers
  • LangDB Pricing
  • Documentation
  • AI Industry Blog
  • Canvas MCP Server
  • Mealie MCP Server
  • AVA MCP Server
  • Readwise MCP
  • MCP Server for Intercom
Back to MCP Servers
MCP NodeJS Debugger

MCP NodeJS Debugger

Public
hyperdrive-eng/mcp-nodejs-debugger

Enables real-time debugging of Node.js applications by providing runtime access and control through Model Context Protocol integration with AI coding assistants like Cursor and Claude Code.

javascript
0 tools
May 30, 2025
Updated Jun 4, 2025

Supercharge Your AI with MCP NodeJS Debugger

MCP Server

Unlock the full potential of MCP NodeJS Debugger through LangDB's AI Gateway. Get enterprise-grade security, analytics, and seamless integration with zero configuration.

Unified API Access
Complete Tracing
Instant Setup
Get Started Now

Free tier available • No credit card required

Instant Setup
99.9% Uptime
10,000+Monthly Requests

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.

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

    + { + "mcpServers": { + "nodejs-debugger": { + "command": "npx", + "args": ["@hyperdrive-eng/mcp-nodejs-debugger"] + } + } + }
  2. Run a Node.js server in debug mode (i.e. with the --inspect flat)

    node --inspect {file.js}
  3. Ask Cursor to debug your Node.js server at runtime

    image

Claude Code

  1. Add to Claude Code

    claude mcp add nodejs-debugger npx @hyperdrive-eng/mcp-nodejs-debugger
  2. Start Claude Code

    claude ╭───────────────────────────────────────────────────────╮ │ ✻ Welcome to Claude Code research preview! │ │ │ │ /help for help │ │ │ │ Found 1 MCP server (use /mcp for status) │ ╰───────────────────────────────────────────────────────╯
  3. Run a Node.js server in debug mode (i.e. with the --inspect flat)

    # In another terminal node --inspect {file.js}
  4. Ask Claude Code to debug your Node.js server at runtime

    > 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

    claude mcp add nodejs-debugger npx mcp-nodejs-debugger
  2. Verify connection

    > /mcp ⎿ MCP Server Status • nodejs-debugger: connected
  3. Remove from Claude Code

    claude remove nodejs-debugger

Cursor

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

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

    image

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

    - { - "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:

    node --inspect ./bin/www
  2. Ask Cursor to set a breakpoint

    image

    image

  3. Create a book at localhost:3000/catalog/book/create

    image

  4. Watch Cursor capture runtime state

    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

const mongoose = … require('mongoose'); console.log('Current mongoose version:', mongoose.version); console.log('Current mongoose connection state:', mongoose.connection.readyState); // Log connection string safely (without password) const connectionString = process.env.MONGODB_URI ||

                                        "mongodb+srv://cooluser:coolpassword@cluster0.cojoign.mongodb.net/local_library?retryWr
                                        ites=true&w=majority&appName=Cluster0";

console.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?
```
Publicly Shared Threads0

Discover shared experiences

Shared threads will appear here, showcasing real-world applications and insights from the community. Check back soon for updates!

Share your threads to help others
Related MCPs5
  • Canvas MCP Server
    Canvas MCP Server

    Enables AI assistants to interact with Canvas LMS via the Model Context Protocol, providing course m...

    Added May 30, 2025
  • Mealie MCP Server
    Mealie MCP Server

    Enables AI assistants to access and interact with your Mealie recipe database via Model Context Prot...

    Added May 30, 2025
  • AVA MCP Server
    AVA MCP Server

    Enables AI applications to access a customizable toolset for an Artificial Virtual Assistant through...

    1 tools
    Added May 30, 2025
  • Readwise MCP
    Readwise MCP

    Enables seamless integration between Large Language Model clients and Readwise by providing standard...

    1 tools
    Added May 30, 2025
  • MCP Server for Intercom
    MCP Server for Intercom

    Enables AI assistants to access, search, and filter Intercom customer support conversations and tick...

    4 tools
    Added May 30, 2025