CDP Tools
MCP server that connects AI assistants to Chrome DevTools Protocol for runtime debugging - set breakpoints, inspect variables, monitor network traffic, and automate browser interactions
What is CDP Tools?
CDP Tools is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to mcp server that connects ai assistants to chrome devtools protocol for runtime debugging - set breakpoints, inspect variables, monitor network traffic, and automate browser interactions
MCP server that connects AI assistants to Chrome DevTools Protocol for runtime debugging - set breakpoints, inspect variables, monitor network traffic, and automate browser interactions
This server falls under the Browser Automation category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- MCP server that connects AI assistants to Chrome DevTools Pr
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx cdp-toolsConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use CDP Tools
CDP Tools MCP Server connects AI assistants to the Chrome DevTools Protocol (CDP), enabling runtime debugging, browser automation, and server management directly from tools like Claude. It supports setting breakpoints, inspecting variables, monitoring network traffic, taking screenshots, discovering DOM elements, and managing multi-agent browser tab isolation—making it a powerful bridge between AI and live browser or Node.js debugging sessions.
Prerequisites
- Node.js 18+ and npm installed
- Google Chrome or Chromium browser installed
- Claude Desktop or Claude Code (claude mcp add command available)
- For Node.js debugging: Node.js application launchable with --inspect flag
- For browser debugging: Chrome started with remote debugging enabled
Add the server to Claude Code (quickest method)
If you are using Claude Code CLI, add the CDP tools server with a single command. This is the fastest way to get started.
claude mcp add cdp-tools -- npx cdp-tools-mcp@latestOr configure Claude Desktop
Add the CDP Tools MCP server to your Claude Desktop configuration file. The server runs via npx so no global install is needed.
{
"mcpServers": {
"cdp-tools": {
"command": "npx",
"args": ["-y", "cdp-tools-mcp@latest"]
}
}
}Launch Chrome with remote debugging enabled
To use browser debugging and automation tools, start Chrome with remote debugging on port 9222.
# macOS
/Applications/Google\ Chrome.app/Contents/MacOS/Google\ Chrome --remote-debugging-port=9222
# Linux
google-chrome --remote-debugging-port=9222
# Windows
chrome.exe --remote-debugging-port=9222Or launch a Node.js process with debugging enabled
To debug a Node.js application, start it with the --inspect flag to expose the V8 debugger on port 9229.
node --inspect=9229 your-app.js
# Or for breaking on first line:
node --inspect-brk=9229 your-app.jsUse the config tool to set connection preferences
CDP Tools includes a built-in config tool to switch between local and global configuration, view current settings, and reset to defaults. Use it to point the server at your Chrome or Node.js debugging port.
CDP Tools Examples
Client configuration
Claude Desktop configuration to run cdp-tools-mcp via npx.
{
"mcpServers": {
"cdp-tools": {
"command": "npx",
"args": ["-y", "cdp-tools-mcp@latest"]
}
}
}Prompts to try
Use these prompts in Claude to debug browsers and Node.js applications via CDP.
- "Navigate to https://example.com, take a screenshot, and list all interactive elements on the page"
- "Set a breakpoint in my Node.js app at line 42 of server.js and inspect the request object"
- "Monitor all network requests on the current Chrome tab and flag any that return 4xx or 5xx status codes"
- "Record my interaction with the checkout flow and create a reproduction sequence for the bug I just triggered"Troubleshooting CDP Tools
CDP Tools cannot connect to Chrome or reports 'connection refused'
Ensure Chrome was started with --remote-debugging-port=9222 before asking Claude to connect. Close any existing Chrome instances first, as only one instance can own the debugging port. Use 'curl http://localhost:9222/json' to verify the debug endpoint is responding.
Node.js breakpoints are set but never hit
Ensure your Node.js process was started with --inspect or --inspect-brk. The --inspect-brk flag pauses execution immediately, making it easier to attach before code runs. Verify the process is listening with 'lsof -i :9229'.
npx cdp-tools-mcp@latest takes too long or fails to download
Install the package globally to avoid repeated downloads: 'npm install -g cdp-tools-mcp'. Then update your MCP config to use 'command: cdp-tools-mcp' without the npx wrapper.
Frequently Asked Questions about CDP Tools
What is CDP Tools?
CDP Tools is a Model Context Protocol (MCP) server that mcp server that connects ai assistants to chrome devtools protocol for runtime debugging - set breakpoints, inspect variables, monitor network traffic, and automate browser interactions It connects AI assistants to external tools and data sources through a standardized interface.
How do I install CDP Tools?
Follow the installation instructions on the CDP Tools GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with CDP Tools?
CDP Tools works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is CDP Tools free to use?
Yes, CDP Tools is open source and available under the MIT license. You can use it freely in both personal and commercial projects.
CDP Tools Alternatives — Similar Browser Automation Servers
Looking for alternatives to CDP Tools? Here are other popular browser automation servers you can use with Claude, Cursor, and VS Code.
Chrome DevTools MCP
★ 40.6kAI-powered Chrome automation server with natural language element detection. Control Chrome browser through MCP protocol for testing, debugging, and performance analysis. Features 91% accuracy in element location, works with free AI models, and suppo
UI TARS Desktop
★ 34.9k📇 🏠 - Browser automation capabilities using Puppeteer, both support local and remote browser connection.
Playwright
★ 32.8kA production-ready browser automation server that enables AI assistants to interact with web pages using tools for navigation, element interaction, and data extraction. It features a built-in Inspector UI and robust crash recovery for reliable automa
Page Agent
★ 18.0kJavaScript in-page GUI agent. Control web interfaces with natural language.
Chrome
★ 11.7kAn extension-based MCP server that enables AI assistants to control your browser, leveraging existing sessions and login states for automation and content analysis. It provides over 20 tools for semantic tab search, interactive element manipulation,
LAMDA
★ 7.8kThe most powerful Android RPA agent framework, next generation mobile automation.
Browse More Browser Automation MCP Servers
Explore all browser automation servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up CDP Tools in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use CDP Tools?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.