Node.js Debugger
Enables AI assistants to debug Node.js applications using Chrome DevTools Protocol. Provides comprehensive debugging capabilities including breakpoints, stepping, variable inspection, expression evaluation, and console monitoring.
What is Node.js Debugger?
Node.js Debugger is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to enables ai assistants to debug node.js applications using chrome devtools protocol. provides comprehensive debugging capabilities including breakpoints, stepping, variable inspection, expression evalu...
Enables AI assistants to debug Node.js applications using Chrome DevTools Protocol. Provides comprehensive debugging capabilities including breakpoints, stepping, variable inspection, expression evaluation, and console monitoring.
This server falls under the Coding Agents category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- Enables AI assistants to debug Node.js applications using Ch
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx node-js-debugger-mcpConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Node.js Debugger
Node.js Debugger MCP brings the full power of Chrome DevTools Protocol into your AI assistant, allowing Claude and other MCP clients to interactively debug Node.js applications. It exposes tools for starting debug sessions, setting breakpoints (including conditional and log points), stepping through code, inspecting scope variables, evaluating expressions, examining call stacks, and reading console output. This enables AI-assisted debugging workflows where you describe a bug and the AI steps through your code to find it.
Prerequisites
- Node.js 14 or higher installed (the application being debugged and the MCP server)
- npm or npx available on your system PATH
- An MCP-compatible client such as Claude Desktop or Cursor
- A Node.js application to debug
Install the devtools-debugger-mcp package
Install the Node.js Debugger MCP package globally or use it via npx. Installing globally makes it easier to reference in your MCP client configuration.
npm install -g devtools-debugger-mcpConfigure your MCP client to use the debugger
Add the debugger MCP server to your MCP client configuration. Use the node command pointing to the installed package's dist/index.js, or use npx directly.
{
"mcpServers": {
"nodejs-debugger": {
"command": "npx",
"args": ["node-js-debugger-mcp"]
}
}
}Start your Node.js application in debug mode
Launch your Node.js application with the --inspect or --inspect-brk flag to expose the Chrome DevTools Protocol endpoint that the MCP server will connect to.
node --inspect-brk your-app.js
# or for a running app on a specific port:
node --inspect=9229 your-app.jsStart a debug session via your AI assistant
Ask your AI assistant to start a debug session. The start_node_debug tool connects to the running Node.js process via the DevTools Protocol WebSocket endpoint.
Set breakpoints and step through code
Instruct your AI to set breakpoints at specific files and line numbers using set_breakpoint, then use resume_execution, step_over, step_into, and step_out to navigate through the code. Use inspect_scopes to examine variable values.
Node.js Debugger Examples
Client configuration (Claude Desktop)
Full claude_desktop_config.json entry for Node.js Debugger MCP.
{
"mcpServers": {
"nodejs-debugger": {
"command": "npx",
"args": ["node-js-debugger-mcp"]
}
}
}Prompts to try
Example prompts that work well once the Node.js Debugger MCP is connected to Claude Desktop.
- "Start a debug session on the Node.js process running on port 9229"
- "Set a breakpoint at line 42 of src/handlers/auth.js and resume execution"
- "Step through the processPayment function and show me all variable values"
- "Set a conditional breakpoint at line 88 that only breaks when user.role === 'admin'"
- "Show me the current call stack and evaluate the expression 'req.body'"
- "Read the console output from the last 20 log entries"Troubleshooting Node.js Debugger
Cannot connect to Node.js debug session — connection refused
Make sure your Node.js app was started with the --inspect or --inspect-brk flag. The default debug port is 9229. Verify the process is running with 'ps aux | grep node' and check that port 9229 is not blocked by a firewall.
Breakpoints are not being hit during execution
If your app is TypeScript or transpiled, ensure source maps are enabled (sourceMap: true in tsconfig.json). The debugger supports source maps but needs them to be generated to map transpiled line numbers back to source.
Debug session disconnects unexpectedly
Node.js debug sessions can time out if the process is idle. Use restart_frame to reconnect, or restart the debug session with start_node_debug. Also ensure only one debugger client is connected at a time.
Frequently Asked Questions about Node.js Debugger
What is Node.js Debugger?
Node.js Debugger is a Model Context Protocol (MCP) server that enables ai assistants to debug node.js applications using chrome devtools protocol. provides comprehensive debugging capabilities including breakpoints, stepping, variable inspection, expression evaluation, and console monitoring. It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Node.js Debugger?
Follow the installation instructions on the Node.js Debugger GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with Node.js Debugger?
Node.js Debugger works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Node.js Debugger free to use?
Yes, Node.js Debugger is open source and available under the MIT License license. You can use it freely in both personal and commercial projects.
Node.js Debugger Alternatives — Similar Coding Agents Servers
Looking for alternatives to Node.js Debugger? Here are other popular coding agents servers you can use with Claude, Cursor, and VS Code.
Dify
★ 142.2kProduction-ready platform for agentic workflow development.
Ruflo
★ 54.0k🌊 The leading agent orchestration platform for Claude. Deploy intelligent multi-agent swarms, coordinate autonomous workflows, and build conversational AI systems. Features enterprise-grade architecture, self-learning swarm intelligence, RAG integrat
Goose
★ 45.7kan open source, extensible AI agent that goes beyond code suggestions - install, execute, edit, and test with any LLM
Antigravity Awesome Skills
★ 38.3kInstallable GitHub library of 1,400+ agentic skills for Claude Code, Cursor, Codex CLI, Gemini CLI, Antigravity, and more. Includes installer CLI, bundles, workflows, and official/community skill collections.
AgentScope
★ 25.5kBuild and run agents you can see, understand and trust.
Serena
★ 24.5kA coding agent toolkit that provides IDE-like semantic code retrieval and editing tools, enabling LLMs to efficiently navigate and modify codebases using symbol-level operations instead of basic file reading and string replacements.
Browse More Coding Agents MCP Servers
Explore all coding agents servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Node.js Debugger in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Node.js Debugger?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.