Skip to main content
Glama
jekyll-001

CDP-MCP Server

by jekyll-001

CDP-MCP Server

A system-wide MCP server that wraps the Chrome DevTools Protocol, giving AI agents full access to low-level browser debugging: breakpoints, stack traces, stepping, scope inspection, network interception, and source maps.

35 MCP Tools

Category

Count

Highlights

Connection

4

Connect, disconnect, list/attach targets

Debugger

15

Breakpoints, stepping, call stacks, scope inspection, eval on frame, exception breakpoints, blackboxing

Runtime

4

JS evaluation, object property drilling, console capture

Network

9

Request monitoring, response bodies, Fetch interception (continue/fail/fulfill)

Source

3

Script listing, source retrieval, source map resolution

Related MCP server: MCP JS Debugger

Quick Start

# Install
npm install

# Build
npm run build

# Launch Chromium with debugging
chromium --remote-debugging-port=9222

# Run (stdio mode for single agent)
node dist/bin/cdp-mcp-server.js --stdio

# Run (HTTP mode for multi-agent)
node dist/bin/cdp-mcp-server.js --http --port 3100

MCP Client Config

{
  "mcpServers": {
    "cdp-debugger": {
      "command": "node",
      "args": ["/path/to/cdp-mcp-server/dist/bin/cdp-mcp-server.js", "--stdio"]
    }
  }
}

CLI Options

--stdio              Stdio transport (default)
--http               HTTP transport
--port <n>           HTTP port (default: 3100)
--chrome-port <n>    Chrome debug port (default: 9222)
--chrome-path <p>    Chrome binary (default: /usr/bin/chromium)
--profile isolated   Temp profile (default)
--profile real       Use real profile
--attach             Only attach, never launch
--launch             Always launch new instance

Architecture

  • Built from scratch — No forks, full control

  • Browser page debugging — Not Node.js-only like alternatives

  • Never kills Chrome — Only detaches CDP session on exit

  • Network interception safety — 30s auto-continue watchdog, emergency cleanup on crash

  • Dual transport — stdio for single-agent, HTTP for multi-agent

License

MIT

Maintenance

ActivityInactive
ResponsivenessNo issues

Related MCP Connectors

Related MCP Servers

  • A
    license
    A
    quality
    C
    maintenance
    Enables AI assistants to debug JavaScript and TypeScript applications by connecting to Chrome DevTools Protocol-compatible debuggers, allowing them to set breakpoints, step through code, inspect variables, and evaluate expressions with full source map support.
    18
    10
    2
    Apache 2.0
  • -
    license
    Not graded
    quality
    Not graded
    maintenance
    Enables AI coding assistants to control and inspect a live Chrome browser for automated debugging, performance analysis, and web interaction. It leverages Puppeteer and Chrome DevTools to provide capabilities like network monitoring, console logging, and automated browser actions.
    -
  • A
    license
    B
    quality
    B
    maintenance
    Enables AI agents to debug code and automate browsers using Chrome DevTools Protocol, supporting breakpoints, variable inspection, and replayable interaction recording.
    35
    339
    16
    MIT