Neura Market
Unagi-cq/cdp-bridge-mcp logo

Unagi-cq/cdp-bridge-mcp

Free

通过 Chrome DevTools Protocol (CDP) 与配套浏览器扩展，将 MCP 客户端桥接到用户的真实浏览器，复用已有会话与登录态进行网页操作。

FreeFree tier
Type
Open Source
Visit Website GitHub (40 stars)

About Unagi-cq/cdp-bridge-mcp

CDP Bridge MCP is an open-source Python bridge service that connects MCP clients to a real browser session via the Chrome DevTools Protocol (CDP) and a companion Chromium extension. It allows any LLM client to read browser tabs, scan pages, execute automation actions, take screenshots, and navigate—all while reusing existing login sessions, cookies, and page states. Unlike stateless HTTP scraping or headless browser automation, CDP Bridge MCP operates on the user's actual open browser, preserving authentication and front-end rendering. It supports both stdio and streamable-http transport modes, enabling personal use on localhost as well as remote deployment for multi-user, multi-profile collaboration. The service uses token-based isolation to separate user sessions, making it suitable for agent products, customer service workstations, data collection, and multi-account management scenarios.

Key Features

Connects MCP clients to a real, user-controlled browser session via CDP and a companion Chromium extension
Reuses existing browser sessions, login states, cookies, and page rendering
Reads browser tabs, scans pages (browser_scan simplifies HTML to reduce token waste), executes automation, takes screenshots, and navigates
Supports multiple browser profiles on the same machine with token-based isolation
Supports multiple users across different computers connecting to a single streamable-http server
Supports stdio and streamable-http transport modes
Lightweight startup: can be run directly via `uvx cdp-bridge` without writing Playwright scripts
Token-based session isolation for multi-tenant deployments
Suitable for agent product integration with remote browser control
Free and open-source (MIT license implied by repository)

Pros & Cons

Pros
  • 复用真实登录态，无需重新登录或搬运 Cookie，可直接操作需认证的网站
  • 支持多 Profile 和多用户并行，适合团队和多账号场景
  • 启动简单，无需编写 Playwright 脚本，一条命令即可运行服务端
  • browser_scan 对 HTML 简化，保留有效内容，减少 LLM token 消耗
  • 支持远端部署，可通过 streamable-http 模式集成到 Agent 产品中
  • 开源免费，代码托管在 GitHub，社区可以贡献和改进
Cons
  • 需要用户安装配套的 Chromium 扩展并保持浏览器运行状态
  • 仅支持 Chromium 内核浏览器（Chrome/Chromium）
  • 不适合无头浏览器自动化或可重复的测试脚本场景（Playwright 更优）
  • 依赖 WebSocket 连接，网络不稳定时可能影响体验

Best For

让大模型读取和操作用户当前正在使用的真实浏览器页面多账号同时管理（如小红书等平台的多Profile操作）客服坐席远程协作，Agent 可以查看和操作授权浏览器数据采集和分析，利用已登录态抓取需认证的网站内容Agent 产品集成真实浏览器能力，提供读取、分析、自动化操作团队内部自动化系统借助真实浏览器执行任务

FAQ

CDP Bridge MCP 与 Playwright MCP 有何不同？
Playwright MCP 侧重于启动新的浏览器实例进行自动化测试和脚本化操作；而 CDP Bridge MCP 专注于连接用户当前正在使用的真实浏览器会话，复用已有登录态，更适合 LLM 在用户页面上进行读取、分析和交互式任务。
CDP Bridge MCP 与 Chrome DevTools MCP 有何不同？
Chrome DevTools MCP 更偏向调试 Chrome DevTools 协议和精细操作，而 CDP Bridge MCP 更关注让 LLM 或 Agent 接管用户的真实浏览器会话，并提供简化的页面扫描和自动化能力。
如何启动 CDP Bridge MCP？
服务端发布到 PyPI，可直接使用 `uvx cdp-bridge` 启动。浏览器端需要加载配套的 Chromium 扩展，配置 Bridge Host、Port 和 Token 即可连接。
是否支持多用户同时接入？
是的。不同用户、不同电脑上的浏览器扩展可以连接到同一个 streamable-http 服务，只要各自使用不同 token，就能并行工作且互不干扰。