# Node Debugger Mcp

> An MCP server for a Node.js debugger. Designed to run locally alongside Claude Code or other coding agents.

- **Type:** MCP server
- **Install:** `agentstack add mcp-qckfx-node-debugger-mcp`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [qckfx](https://agentstack.voostack.com/s/qckfx)
- **Installs:** 0
- **Category:** [Developer Tools](https://agentstack.voostack.com/c/developer-tools)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [qckfx](https://github.com/qckfx)
- **Source:** https://github.com/qckfx/node-debugger-mcp

## Install

```sh
agentstack add mcp-qckfx-node-debugger-mcp
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Node.js Debugger MCP Server

An MCP server that provides Node.js debugging capabilities with process management for AI agents.

  

## Features

- **Process Management**: Start/stop Node.js processes with debugging enabled
- **Debugging Tools**: Set breakpoints, step through code, evaluate expressions
- **Inspector Integration**: Connect to Node.js Inspector API
- **AI Agent Friendly**: Designed for long-running debugging sessions

## Installation

1. Build the server:
   ```bash
   npm install
   npm run build
   ```

2. **For Project-Specific Use**: The `.mcp.json` file is already configured in this project

3. **For User-Wide Use**: Add to your global Claude Code configuration:
   ```bash
   claude mcp add --scope user debugger-mcp node /absolute/path/to/debugger-mcp/build/index.js
   ```

4. **For Global Use**: Copy the `.mcp.json` to your projects or add to global config

## Usage with Claude Code

Once configured, you'll have access to these tools in Claude Code:

### Process Management
- `start_node_process` - Launch Node.js scripts with debugging
- `kill_process` - Terminate processes by PID
- `list_processes` - Show all managed processes

### Debugging
- `attach_debugger` - Connect to debug port
- `set_breakpoint` - Set breakpoints with optional conditions
  - **Important**: Use full `file://` URLs for reliable breakpoint hits
  - Example: `file:///Users/you/project/script.js`
- `step_debug` - Step through code (next/step/continue/out)
- `pause_execution` - Manually pause a running process
- `evaluate_expression` - Evaluate expressions in debug context

### Resources
- `debug://session` - Current debug session state
- `debug://processes` - List of managed processes

## Example Usage

1. Start a Node.js process:
   ```
   Use the start_node_process tool with script: "example-app.js"
   ```

2. Attach debugger:
   ```
   Use attach_debugger tool with the port returned from step 1
   ```

3. Set breakpoints and debug:
   ```
   # Set a breakpoint using full file URL
   Use set_breakpoint tool with:
   - file: "file:///absolute/path/to/example-app.js"
   - line: 5
   
   # Control execution
   Use step_debug tool with action: "continue"
   ```

## Key Features

- **Automatic Pause on Start**: Uses `--inspect-brk` flag to pause at first line
- **Full Chrome DevTools Protocol**: Real debugging, not simulation
- **Reliable Breakpoints**: Use `file://` URLs for consistent breakpoint hits
- **Process Management**: Track and manage multiple debugging sessions

## Testing

Test with the included example app:
```bash
node --inspect=9229 example-app.js
```

Then use the MCP tools to debug it!

## Debug the MCP Server

```bash
npm run inspector
```

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [qckfx](https://github.com/qckfx)
- **Source:** [qckfx/node-debugger-mcp](https://github.com/qckfx/node-debugger-mcp)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-qckfx-node-debugger-mcp
- Seller: https://agentstack.voostack.com/s/qckfx
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.