devtools-mcp
A MCP server that provides Chrome DevTools Protocol access to LLMs.
- Execute any CDP command through the
cdp_commandtool - Automatic binary data handling - large responses (screenshots, PDFs) are saved to files
Setup
- Start Chrome with remote debugging:
/Applications/Google\ Chrome.app/Contents/MacOS/Google\ Chrome \
--remote-debugging-port=9222 \
--remote-debugging-address=127.0.0.1 \
--user-data-dir=/tmp/chrome-debug \
--no-first-run \
--disable-default-apps
- Install dependencies:
npm install
- Add as local MCP server. E.g. with Claude Code:
claude mcp add devtools-server -- npx tsx ~/projects/devtools-mcp/src/index.ts
Usage
The server exposes a single cdp_command tool that accepts:
method: Any CDP command (e.g., "Page.navigate", "Runtime.evaluate")params: JSON string of command parameters (optional)
Binary data (screenshots, etc.) is automatically saved to ./cdp-output/ with file path references returned instead of raw data.
