Browser MCP over CDP

by dumitrubogdanmihai

418 downloads
Not rated
GitHub

About

MCP Server that manages a Chrome browser using the Chrome DevTools Protocol (CDP)

Details

Author
dumitrubogdanmihai
Downloads
418
Categories
Automation

- Full-page screenshot capture (not just viewport)
- Accessibility tree extraction with relevant parts
- Enriched deep DOM including iframes, shadow DOM, and listeners
- Interactive actions: click, keys, input value updates
- Navigation: open URL, back, forward, reload
- Remote browser via Docker with Selenoid and VNC

Prerequisites are Docker, Docker Compose, and Python. Run Selenoid Selenium Hub by pulling the required Docker images and executing docker-compose up inside the selenoid directory. Copy and adjust config-example.json, then configure it for your MCP client (Claude, VS Code, or Cursor). View the live browser at http://localhost:8080/. A playground notebook (playground.ipynb) is also provided.

Browser MCP over CDP

MCP Server that manages a Chrome browser using the Chrome DevTools Protocol (CDP)

This project exposes tools to navigate, interact and access a browser tab. The browser is controller using CDP and because of this:
1. the page is exported as full height screenshoot, accessibility tree and enriched deep DOM
1. the screenshoot captures whole page, not just the visible scrolled are
2. the accessibility tree contains most relevand parts
3. the enriched deep DOM contains
1. nested iframes, shadow DOM, pseudo-elements, etc.
3. per element attached listeners (for e.g. onClick, onKeyDown, etc), including the callback function code (for better or for worse)
4. per element relevant resolved styles
2. the page is interactable via click, keys and input value update functions
3. the page is navigable with basic open URL, back, forward and reload functions

The browser is running remotely on Docker using Selenoid with VNC enabled, available at http://localhost:8080/.

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.