whatisgithub

What is cdp-bridge-mcp?

unagi-cq/cdp-bridge-mcp — explained in plain English

Analysis updated 2026-05-18

85PythonAudience · developerComplexity · 3/5Setup · moderate

In one sentence

A Python MCP server that lets AI coding agents read and control the browser tabs you already have open, reusing your logged-in sessions.

Mindmap

mindmap
  root((cdp bridge mcp))
    What it does
      Connects AI to real browser
      Reuses logged in sessions
      No re authentication
    Tech stack
      Python
      Chrome extension
      WebSocket
    Use cases
      Scrape authenticated pages
      Read logged in sites
      Automate existing tabs
    Audience
      AI agent developers

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Let an AI coding agent read content from sites you are already logged into.

USE CASE 2

Scrape data from authenticated pages without exporting cookies or credentials.

USE CASE 3

Automate interactions in your real running browser instead of a fresh headless instance.

USE CASE 4

Share one browser connection across multiple AI clients using HTTP mode.

What is it built with?

PythonChrome ExtensionWebSocketMCP

How does it compare?

unagi-cq/cdp-bridge-mcpitalozucareli/zabbix-observabilitylllyasviel/singlefiledb
Stars858585
LanguagePythonPythonPython
Last pushed2023-11-24
MaintenanceDormant
Setup difficultymoderatemoderateeasy
Complexity3/53/52/5
Audiencedeveloperops devopsdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires installing a companion Chrome extension alongside the Python server.

So what is it?

CDP Bridge MCP is a Python server that lets an AI coding agent like Claude Code or Codex read and interact with the browser tabs you already have open, using your existing logged-in sessions. The README is written primarily in Chinese. Most browser automation tools like Playwright launch a fresh, separate browser instance with no saved logins or cookies. CDP Bridge MCP works differently: it connects to your real running browser through a companion Chrome extension. Because it reuses your actual session, the AI can immediately access sites you are already logged into without needing to re-authenticate or export credentials. It works using CDP (Chrome DevTools Protocol), the low-level API that Chrome exposes for automation and debugging. The extension installed in your browser connects back to the Python server over a WebSocket connection. When an AI agent calls a tool like browser_scan or browser_execute_js, the server passes the instruction through that WebSocket to the extension, which executes it in the actual page and returns the result. The browser_scan tool strips scripts and styles from the page HTML before returning it, reducing the amount of text sent to the language model. The server implements the MCP (Model Context Protocol), a standard interface for giving AI assistants access to external tools. It supports two connection modes: a simple local mode where the MCP client starts the server as a child process, and an HTTP mode suitable for hosting on a remote server so multiple clients can share one browser connection. A developer building an AI agent that needs to read web content behind login walls, scrape data from authenticated pages, or automate interactions in an existing browser session would use this.

Copy-paste prompts

Prompt 1
Set up CDP Bridge MCP so Claude Code can read the browser tab I already have open.
Prompt 2
Use browser_scan to pull the text content of my currently open dashboard page.
Prompt 3
Explain how to install the companion Chrome extension for this MCP server.
Prompt 4
Show me how to run this MCP server in HTTP mode for multiple clients.

Frequently asked questions

What is cdp-bridge-mcp?

A Python MCP server that lets AI coding agents read and control the browser tabs you already have open, reusing your logged-in sessions.

What language is cdp-bridge-mcp written in?

Mainly Python. The stack also includes Python, Chrome Extension, WebSocket.

How hard is cdp-bridge-mcp to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is cdp-bridge-mcp for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.