Chrome DevTools MCP
When To Use
- •User asks to start/connect/check Chrome DevTools MCP.
- •Browser automation or debugging tasks need MCP connectivity.
Repository Source Of Truth
- •VS Code MCP config:
.vscode/mcp.json - •Configured server command:
- •
npx chrome-devtools-mcp@latest --browser-url=http://127.0.0.1:9222
- •
Start Sequence
- •Ensure Chrome is running with remote debugging enabled on port
9222. - •Start MCP server:
- •
npx chrome-devtools-mcp@latest --browser-url=http://127.0.0.1:9222
- •
- •Validate connection by listing/opening a page via MCP client.
Stop Sequence
- •Stop the MCP server process from the running terminal session (
Ctrl+C).
Troubleshooting
- •If connection fails, verify remote-debugging port is open and matches
--browser-url. - •If
npxfails, verify Node/npm availability and network/package resolution. - •If pages are not visible, verify the same Chrome profile/session is targeted.
Boundaries
- •Do not assume the browser is already launched with remote debugging.
- •Do not change
.vscode/mcp.jsonunless explicitly requested.