Brand LogoBrand Logo (Dark)
HomeAI AgentsToolkitsGitHub PicksSubmit AgentBlog

Categories

  • Art Generators
  • Audio Generators
  • Automation Tools
  • Chatbots & AI Agents
  • Code Tools
  • Financial Tools

Categories

  • Large Language Models
  • Marketing Tools
  • No-Code & Low-Code
  • Research & Search
  • Video & Animation
  • Video Editing

GitHub Picks

  • DeerFlow — ByteDance Open-Source SuperAgent Harness

Latest Blogs

  • OpenClaw vs Composer 2 Which AI Assistant Delivers More Value
  • Google AI Studio vs Anthropic Console
  • Stitch 2.0 vs Lovable Which AI Design Tool Wins in 2026
  • Monetizing AI for Solopreneurs and Small Teams in 2026
  • OpenClaw vs MiniMax Which AI Assistant Wins in 2026

Latest Blogs

  • OpenClaw vs KiloClaw Is Self-Hosting Still Better
  • OpenClaw vs Kimi Claw
  • GPT-5.4 vs Gemini 3.1 Pro
  • Farewell to Bloomberg Terminal as Perplexity Computer AI Redefines Finance
  • Best Practices for OpenClaw
LinkStartAI© 2026 LinkstartAI. All rights reserved.
Contact UsAbout
  1. Home
  2. GitHub Picks
  3. chrome-devtools-mcp
chrome-devtools-mcp logo

chrome-devtools-mcp

Wraps Chrome DevTools into MCP tools so coding agents can inspect DOM, Network, and Console for reproducible debugging.
26.1kTypeScriptApache-2.0
typescriptnodejsmcp-serverchrome-devtools-protocolbrowser-debugging
agent-tools
frontend-debugging
e2e-troubleshooting
alternative-to-playwright
alternative-to-selenium
alternative-to-puppeteer
alternative-to-manual-devtools

What is it?

chrome-devtools-mcp turns interactive browser debugging into repeatable tool calls for coding agents. It exposes inspection, network capture, console observation, and performance sampling through the Model Context Protocol (MCP), while driving real sessions via the Chrome DevTools Protocol. For frontend and full-stack teams, this makes debugging workflows portable: reproduction steps, evidence collection, and fix verification can run deterministically instead of relying on screenshots and tribal knowledge.

Pain Points vs Innovation

✕Traditional Pain Points✓Innovative Solutions
Manual DevTools debugging is hard to standardize: evidence differs across people and reproduction steps get lost.chrome-devtools-mcp exposes debugging actions as MCP tools so agents can execute structured calls and return comparable evidence.
Test frameworks are great at running scripts, but debugging-grade evidence (DOM/Network/Console/Performance) often lacks a unified interface.Using CDP as the execution plane makes observation and sampling part of an orchestrated debugging pipeline.

Architecture Deep Dive

MCP tool surface: debugging as callable interfaces
Inspection, network observation, console reading, and performance sampling are exposed as MCP tools with structured I/O for automation and auditability.
CDP execution plane: connect and drive sessions
The server connects to a Chrome debugging port via CDP and manages targets, sessions, and event streams so observations and samples are reproducible operations.
Evidence-chain outputs: minimal sufficient debugging artifacts
Exports selectors, request/response summaries, console errors, performance slices, and artifacts like screenshots/traces in durable formats for local and CI reruns.

Deployment Guide

1. Install runtime (Node.js)

bash
1node --version

2. Clone and install dependencies

bash
1git clone https://github.com/ChromeDevTools/chrome-devtools-mcp.git && cd chrome-devtools-mcp && npm install

3. Start the MCP server

bash
1npm run start

4. Launch Chrome with remote debugging enabled

bash
1google-chrome --remote-debugging-port=9222 --user-data-dir=/tmp/chrome-devtools-mcp

5. Register the server in your MCP client and verify tools are available

bash
1# Add the server config, then run a tools/list equivalent to validate

Use Cases

Core SceneTarget AudienceSolutionOutcome
Turn production bugs into reproducible evidence packsfrontend/full-stack engineerscapture DOM state, key requests, console errors, and performance slicesrepeatable debugging scripts instead of hand-wavy descriptions
Automatic evidence capture for CI failuresteams running E2E/regressionexport network/console/trace artifacts on failureless time spent chasing “works on my machine” repros
Support-friendly page forensicssupport engineers and dev partnerscollect page state and error signals via toolsfaster triage and better handoff to engineering

Limitations & Gotchas

Limitations & Gotchas
  • It connects via a remote debugging port, which expands the attack surface; use on localhost or controlled networks and restrict reachable targets.
  • CDP behavior can differ across Chromium versions; pin browser versions in target environments and validate compatibility.

Frequently Asked Questions

How is this different from E2E frameworks like Playwright?▾
E2E focuses on scripted actions and assertions. This focuses on debugging-grade forensics: toolizing DOM/Network/Console/Performance observation so an agent can collect evidence, explain behavior, and guide fixes.
How do I reduce the security risk of the remote debugging port?▾
Bind the port to localhost, use an isolated user-data-dir, restrict reachable targets to controlled sites, and never expose the port publicly.
Can it run in CI or headless environments?▾
Yes if you can start a Chromium instance that CDP can attach to and keep the environment stable. Pin browser versions and persist artifacts (trace, console, network summaries) as build outputs.
View on GitHub

Project Metrics

Stars26.1 k
LanguageTypeScript
LicenseApache-2.0
Deploy DifficultyMedium

Table of Contents

  1. 01What is it?
  2. 02Pain Points vs Innovation
  3. 03Architecture Deep Dive
  4. 04Deployment Guide
  5. 05Use Cases
  6. 06Limitations & Gotchas
  7. 07Frequently Asked Questions

Related Projects

Pi Monorepo
Pi Monorepo
14.1 k·TypeScript
QMD
QMD
9.6 k·TypeScript
NanoClaw
NanoClaw
8.6 k·TypeScript
DeerFlow — ByteDance Open-Source SuperAgent Harness
DeerFlow — ByteDance Open-Source SuperAgent Harness
26.1 k·Python