CDP

CDP MCP is a Chrome DevTools Protocol-based MCP server that lets your agents automate browser tasks by directly talking to Chrome. It auto-discovers interactive elements, generates selectors, and verifies interactions, while remembering site details for more reliable, repeated automation.

How to use

To use this MCP server with your MCP client, run it as a local stdio server and configure your client to connect to it. The server exposes a set of commands you can call to launch Chrome, discover elements, interact with pages, read data, and remember site context.

Key usage pattern: connect to the local CDP MCP server, navigate to a target page, discover elements, perform interactions with built-in verification, and confirm outcomes. You can also scan the page structure, store memory about forms and frames, and debug issues with epoch tracking to manage per-conversation scans.

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

How to install

Prerequisites: ensure you have Node.js 18+ installed on your system. You will also need a Chrome/Chromium binary accessible for DevTools Protocol connections.

Step-by-step install and build sequence you should follow:

npm install
npm run build

Additional setup and notes

Configure the MCP client to connect to the local server. Use the stdio configuration shown below to run the MCP server from your client setup. The setup assumes you will start the MCP server with Node and point to the built entry file.

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

Tips and capabilities

• Auto-discovery of interactive elements with generated CSS selectors
• Built-in verification for actions like typing and clicking
• Site memory that tracks iframe locations, shadow DOM elements, and learned selector patterns
• Epoch tracking to manage scans across conversation contexts
• Minimal dependencies: just the WebSocket client and CDP protocol usage

Available tools

cdp_launch

Launch Chrome with CDP enabled in an isolated profile to start automation sessions.

cdp_connect

Connect to an existing Chrome instance that has remote debugging enabled.

cdp_list_tabs

List all open tabs to identify targets for automation.

cdp_navigate

Navigate to a URL, go back, go forward, or refresh the page.

cdp_find_elements

Discover all interactive elements on the page with auto-generated selectors.

cdp_interact

Perform interactions like click, type, check, select, and upload with built-in verification.

cdp_read

Read page text, element text, and input values for validation.

cdp_screenshot

Capture screenshots of the viewport or the full page.

cdp_wait

Wait for specific conditions like element presence, text, or navigation events.

cdp_execute

Run arbitrary JavaScript as an escape hatch for advanced actions.

cdp_list_frames

List all frames, including main document and iframes.

cdp_frame_interact

Interact with elements inside frames/iframes.

cdp_type_text

Type text at the cursor position (useful for React/Vue/Angular apps).

cdp_click_coordinates

Click at exact x,y coordinates on the page.

cdp_set_value

Set input values with proper event dispatch to trigger change events.

cdp_monaco_editor

Interact with Monaco/VS Code style editors embedded in pages.

cdp_upload_shadow

Upload files to shadow DOM-based inputs.

cdp_submit_form

Submit forms reliably across frameworks like React/Vue/Angular.

cdp_site_scan

Scan page structure and cache results per epoch for fast reuse.

cdp_site_info

Retrieve stored information about the current site or domain.

cdp_site_note

Add notes or selector patterns you learn during automation.

cdp_site_list

List all remembered sites in your session.

cdp_site_clear

Forget a site to force a fresh scan on next visit.

cdp_epoch_info

Debug information for epoch tracking and memory usage.

cdp_track_bug

Track a bug in CDP-MCP and log it for review.

cdp_list_bugs

List all tracked bugs across sessions.

cdp_fix_bug

Mark a tracked bug as fixed and remove it from the list.