Browser MCP over CDP
by dumitrubogdanmihai
This project exposes tools to navigate, interact and access a browser tab using the Chrome DevTools Protocol (CDP). The server allows for full height screenshots, accessibility tree access, enriched deep DOM inspection, and browser interaction.
Last updated: N/A
What is Browser MCP over CDP?
A MCP server that manages a Chrome browser using the Chrome DevTools Protocol (CDP). It provides tools to navigate, interact with, and access a browser tab, exporting the page as a full height screenshot, accessibility tree, and enriched deep DOM.
How to use Browser MCP over CDP?
- Run Selenoid Selenium Hub using Docker Compose. 2. Configure the config-example.json file with appropriate paths. 3. Open http://localhost:8080/ in your browser to see the browser live. 4. Refer to playground.ipynb for examples.
Key features of Browser MCP over CDP
Full height screenshots of the entire page
Accessibility tree with relevant parts
Enriched deep DOM with nested iframes, shadow DOM, pseudo-elements, attached listeners and resolved styles
Interactable page via click, keys, and input value updates
Basic navigation functions (open URL, back, forward, reload)
Use cases of Browser MCP over CDP
Automated browser testing
Web scraping with full page context
Generating visual representations of entire web pages
Analyzing web page structure and behavior
FAQ from Browser MCP over CDP
What is CDP?
What is CDP?
Chrome DevTools Protocol allows tools to instrument, inspect, debug and profile Chrome, Edge, Safari and other Chromium-based browsers.
What is Selenoid?
What is Selenoid?
Selenoid is a powerful open source implementation of Selenium hub using Docker to launch browsers.
Why use Docker?
Why use Docker?
Docker provides a consistent and isolated environment for running the browser, ensuring reproducibility and simplifying deployment.
How do I configure the server?
How do I configure the server?
Modify the config-example.json file with the correct paths and settings for your environment.
Where can I find more information about MCP?
Where can I find more information about MCP?
See https://modelcontextprotocol.io/ for more information about Model Context Protocol.