MCP JS Debugger

Name: MCP JS Debugger
Author: johngrimes

@johngrimes

Repository

About MCP JS Debugger

Debug JavaScript and TypeScript applications through the Chrome DevTools Protocol with full source map support.

#mcp-js-debugger #javascript #typescript #debugging

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "mcp-js-debugger": {
      "command": "npx",
      "args": [
        "mcp-js-debugger"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is MCP JS Debugger?

MCP JS Debugger is an MCP server that enables AI assistants to connect to any Chrome DevTools Protocol (CDP)-compatible debugger—such as Node.js, Chrome, or Edge—and perform full debugging operations on JavaScript and TypeScript applications. It is designed for developers who want AI-assisted debugging with breakpoints, stepping, variable inspection, and source map support.

How to use MCP JS Debugger?

Add the server using claude mcp add mcp-js-debugger -- npx mcp-js-debugger, then start your Node.js application with the --inspect-brk flag. The server automatically connects to the CDP-compatible debugger and exposes debugging tools to the AI assistant.

Key features of MCP JS Debugger

Set and manage breakpoints
Step through code (over, into, out)
Inspect call stacks and variables
Evaluate expressions in any stack frame
Modify variable values during execution
Pause on exceptions with full source map support

Use cases of MCP JS Debugger

Debug a Node.js backend service with AI‑guided breakpoints and variable inspection
Debug a browser application using Chrome or Edge DevTools Protocol
Debug transpiled TypeScript or bundled JavaScript while viewing original source locations
Integrate an AI assistant into an existing debugging workflow for step‑by‑step analysis

FAQ from MCP JS Debugger

What debuggers are compatible with MCP JS Debugger?

Any debugger that implements the Chrome DevTools Protocol, including Node.js (with --inspect), Chrome, and Edge.

How do I get started with MCP JS Debugger?

Run claude mcp add mcp-js-debugger -- npx mcp-js-debugger and then start your Node.js app with the --inspect-brk flag.

Does MCP JS Debugger support source maps?

Yes, full source map support is included, allowing you to debug TypeScript, bundled code, or any compiled JavaScript while viewing original source locations.

What runtime environment is required?

It requires Node.js and the npx command to execute the MCP server package. The debuggee (e.g., Node.js, Chrome) must be launched with CDP enabled.

How does the server transport work?

The server uses standard I/O (stdio) as the transport layer, typical for MCP servers invoked via npx or claude mcp add. There is no additional authentication mechanism described.