Chrome Debugger MCP Server

Chrome breakpoint debugging MCP server for inspecting runtime values and stepping through code

Local serverstdio

What is the Chrome Debugger MCP MCP server?

Chrome breakpoint debugging MCP server for inspecting runtime values and stepping through code. That is what the chrome debugger mcp mcp server brings to an AI assistant: the same capability, reachable through the Model Context Protocol rather than a separate app or dashboard.

The short version

chrome-debugger-mcp exposes Chrome DevTools Protocol primitives as MCP tools so an AI agent can attach to a real Chrome tab, pause execution, inspect scope values, evaluate expressions inside the current call frame, and step through code with runtime facts instead of guessing from static source.

  • guessing which tab to attach to
  • concluding behavior without inspecting runtime values
  • ending the turn between reloadPage() and waitForSpecificPause()

Getting it running

Installation goes through your MCP client rather than a global install: point it at chrome-debugger-mcp on npm and it is fetched when the client starts. The copy-paste blocks for Claude Desktop, Claude Code and Cursor are further down this page.

The tools it exposes

The server publishes 14 tools. What each one is for:

  • startDebuggingSession — returns the recommended debugging workflow and critical rules for agent behavior
  • launchChrome — launches a dedicated Chrome instance with remote debugging enabled
  • listTargets — lists available Chrome tabs and requires the user to pick one
  • connect — attaches to the confirmed tab
  • setBreakpoint — creates a CDP breakpoint without modifying source files
  • removeBreakpoint — removes a breakpoint created by setBreakpoint
  • reloadPage — reloads the current page through CDP
  • waitForSpecificPause — waits for the next pause and checks whether it matches a target file and line
  • waitForPause — waits for any pause without location matching
  • getScopeVariables — reads local, closure, and module scope values from the paused frame
  • evaluate — executes JavaScript in the paused call frame
  • resume — resumes execution after inspection

What it needs from you

  • Google Chrome installed locally - An MCP client that supports stdio servers and tool calling - Access to the application you want to debug - Local source access if you plan to insert temporary debugger; statements

Things to watch

  • It runs with your machine's permissions. That is convenient and also the reason to think about what you point it at before you approve a tool call.
  • With 14 tools registered it takes up a noticeable share of the context window; turn it off in projects that never touch Chrome Debugger MCP.
  • Keep per-call confirmation enabled while you learn its behaviour; it is the cheapest safeguard you have.

How it compares

Plenty of developer tooling servers cover similar ground. The differences that matter in practice are scope of access and how much setup stands between you and a working tool call. Chrome Debugger MCP's toolset — startDebuggingSession, launchChrome, listTargets and 11 more — is a fair guide to whether it matches your workflow. It is maintained by BitePro; worth a glance at recent repository activity before you build anything load-bearing on it.

SyncDev reviews every entry in this directory against the project's own documentation before publishing, and revisits them as servers change.

Available tools

ToolWhat it does
startDebuggingSessionreturns the recommended debugging workflow and critical rules for agent behavior
launchChromelaunches a dedicated Chrome instance with remote debugging enabled
listTargetslists available Chrome tabs and requires the user to pick one
connectattaches to the confirmed tab
setBreakpointcreates a CDP breakpoint without modifying source files
removeBreakpointremoves a breakpoint created by setBreakpoint
reloadPagereloads the current page through CDP
waitForSpecificPausewaits for the next pause and checks whether it matches a target file and line
waitForPausewaits for any pause without location matching
getScopeVariablesreads local, closure, and module scope values from the paused frame
evaluateexecutes JavaScript in the paused call frame
resumeresumes execution after inspection
getStatusnon-blocking polling for connected or paused state
forcePauserequests a pause at the next JavaScript statement

How to install the Chrome Debugger MCP MCP server

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

Configuration as documented by the project. Restart the client after saving.

Configuration

  • Google Chrome installed locally - An MCP client that supports stdio servers and tool calling - Access to the application you want to debug - Local source access if you plan to insert temporary debugger; statements

Example prompts to try

  • Use Chrome Debugger MCP to startDebuggingSession.
  • Use Chrome Debugger MCP to launchChrome.
  • Use Chrome Debugger MCP to listTargets.

Frequently asked questions

It connects Chrome Debugger MCP to MCP-compatible AI assistants such as Claude and Cursor, exposing 14 tools (startDebuggingSession, launchChrome, listTargets, and more) that the assistant can call on your behalf. Instead of copying data back and forth by hand, the assistant works with Chrome Debugger MCP directly.