CDP Bridge
MCP server that bridges clients to a real browser through CDP and a companion extension.
What is CDP Bridge?
CDP Bridge is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to mcp server that bridges clients to a real browser through cdp and a companion extension.
MCP server that bridges clients to a real browser through CDP and a companion extension.
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 bridges clients to a real browser through CD
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx cdp-bridgeConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use CDP Bridge
CDP Bridge is an MCP server that connects AI assistants to a real, running browser instance through the Chrome DevTools Protocol (CDP) and a companion browser extension. Unlike headless automation tools, it operates on the user's actual browser session with their existing logins and cookies intact. Developers and automation engineers use it to have Claude control a live Chrome browser — navigating pages, reading content, executing JavaScript, and taking screenshots — all from natural language instructions.
Prerequisites
- Python 3.10+ with uvx available (install via `pip install uv`)
- Google Chrome or Chromium browser installed
- The CDP Bridge companion browser extension installed from the GitHub releases page
- An MCP-compatible client such as Claude Desktop
Install the CDP Bridge companion extension
Download and install the companion Chrome extension from the project's GitHub releases page. This extension bridges the MCP server to your browser's CDP interface.
Enable the extension in Chrome
Open Chrome and navigate to chrome://extensions, enable Developer mode, then load the unpacked extension from the downloaded folder. The extension icon should appear in your toolbar.
Install uvx and the cdp-bridge package
Install uv which provides the uvx command used to run the CDP Bridge MCP server without a separate install step.
pip install uvConfigure Claude Desktop for stdio mode
Add the CDP Bridge server to your Claude Desktop configuration. The stdio mode works with your local browser session directly.
{
"mcpServers": {
"cdp-bridge": {
"command": "uvx",
"args": ["cdp-bridge@latest"]
}
}
}Connect and test the browser bridge
Restart Claude Desktop and ask it to get the current browser tabs — this confirms the MCP server is communicating with your browser through the extension.
CDP Bridge Examples
Client configuration
Claude Desktop configuration for CDP Bridge in stdio mode, which connects to your local Chrome instance.
{
"mcpServers": {
"cdp-bridge": {
"command": "uvx",
"args": ["cdp-bridge@latest"]
}
}
}Prompts to try
Example prompts for controlling a real browser session through CDP Bridge.
- "List all my open browser tabs and their URLs"
- "Navigate to https://news.ycombinator.com and summarize the top 5 stories"
- "Take a screenshot of the current tab"
- "Execute JavaScript on the active tab to get the page title and all link hrefs"
- "Wait until the loading spinner disappears then read the page content"Troubleshooting CDP Bridge
browser_get_tabs returns an empty list or connection refused error
Ensure the CDP Bridge companion extension is installed and active in Chrome. Check that Chrome is running and the extension icon is visible. Try clicking the extension icon to verify it shows a connected status.
uvx cdp-bridge@latest fails to install or run
Make sure uv is installed and up to date (`pip install -U uv`). Try running `uvx cdp-bridge@latest` directly in your terminal to see error output before adding it to the Claude Desktop config.
HTTP mode authentication fails with 401
When using streamable-http transport, set the CDP_BRIDGE_TOKENS environment variable to a comma-separated list of allowed tokens. Include the same token as a Bearer header in your client configuration.
Frequently Asked Questions about CDP Bridge
What is CDP Bridge?
CDP Bridge is a Model Context Protocol (MCP) server that mcp server that bridges clients to a real browser through cdp and a companion extension. It connects AI assistants to external tools and data sources through a standardized interface.
How do I install CDP Bridge?
Follow the installation instructions on the CDP Bridge GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with CDP Bridge?
CDP Bridge works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is CDP Bridge free to use?
Yes, CDP Bridge is open source and available under the MIT license. You can use it freely in both personal and commercial projects.
CDP Bridge Alternatives — Similar Browser Automation Servers
Looking for alternatives to CDP Bridge? 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 Bridge 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 Bridge?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.