CDP Bridge MCP 是一个连接 MCP 客户端与真实浏览器会话的桥接服务。它通过配套的 Chromium 扩展接入浏览器页面，让大模型客户端可以读取标签页、扫描页面、执行 JavaScript、截图、导航和读取 Cookie。

和普通浏览器 MCP 不同，它可以复用你浏览器里已有的登录态、Cookie 和页面状态。

为什么用 CDP Bridge MCP

痛点对比

问题	Playwright MCP	CDP Bridge MCP
登录态	每次新建浏览器实例	复用已有登录态
Cookie	需要手动搬运	自动读取
页面上下文	丢失	保持
前端渲染	需要等待	直接获取

核心优势

优势	说明
复用真实登录态	连接已有登录的浏览器标签页，不用重新登录
保持页面状态	Cookie、登录态、页面上下文全部保留
适合 LLM 交互	页面 HTML 自动简化，减少 token 浪费
启动链路轻量	uvx cdp-bridge 一行启动

项目信息

• GitHub：github.com/Unagi-cq/cdp-bridge-mcp
• 语言：Python
• 安装：uvx cdp-bridge 或 pip install cdp-bridge-mcp

安装步骤

1. 安装 Python 包

# 使用 uv（推荐）
uvx cdp-bridge

# 或使用 pip
pip install cdp-bridge-mcp

2. 安装 Chromium 扩展

1. 下载扩展：项目 releases 页面
2. 打开 Chrome：chrome://extensions/
3. 开启"开发者模式"
4. 点击"加载已解压的扩展程序"
5. 选择扩展文件夹

3. 启动服务

# 默认端口 9222
uvx cdp-bridge

# 自定义端口
uvx cdp-bridge --port 9223

4. 连接扩展

1. 点击 Chrome 工具栏的扩展图标
2. 点击"连接"按钮
3. 状态变为"已连接"即可

4个AI客户端配置

Claude Desktop

// %APPDATA%/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "cdp-bridge": {
      "command": "uvx",
      "args": ["cdp-bridge"]
    }
  }
}

Cursor

// .cursor/mcp.json
{
  "mcpServers": {
    "cdp-bridge": {
      "command": "uvx",
      "args": ["cdp-bridge"]
    }
  }
}

VS Code Copilot

// .vscode/mcp.json
{
  "mcpServers": {
    "cdp-bridge": {
      "command": "uvx",
      "args": ["cdp-bridge"]
    }
  }
}

Janet

// janet 配置文件
{
  "mcpServers": {
    "cdp-bridge": {
      "command": "uvx",
      "args": ["cdp-bridge"]
    }
  }
}

核心工具

工具	功能
browser_tabs	列出所有打开的标签页
browser_connect	连接到指定标签页
browser_navigate	导航到 URL
browser_scan	扫描页面，返回简化后的 HTML
browser_snapshot	获取页面完整快照
browser_click	点击元素
browser_type	输入文本
browser_screenshot	截图
browser_cookies	读取 Cookie
browser_js	执行 JavaScript

使用示例

示例1：扫描页面

扫描当前标签页的页面内容

返回简化后的 HTML，过滤了脚本、样式和不可见元素。

示例2：点击按钮

点击页面上的"登录"按钮

示例3：读取Cookie

读取 github.com 的所有 Cookie

示例4：执行JS

执行 JavaScript 获取页面标题

vs Playwright / Chrome DevTools MCP

对比项	Playwright MCP	Chrome DevTools MCP	CDP Bridge MCP
登录态	❌	❌	✅
页面上下文	❌	❌	✅
启动速度	快	快	最快
适合场景	自动化测试	调试	LLM 交互
Token 消耗	高	高	低（页面简化）

适用场景

场景	说明
需要登录态的操作	GitHub、微信后台等
分析已登录页面	邮箱、社交媒体
自动化填表	复用表单状态
截图带登录态	登录后的页面

常见问题

Q：为什么需要 Chromium 扩展？

A： 扩展负责建立浏览器和 MCP 服务之间的连接，实现跨域访问和状态共享。

Q：和 Playwright MCP 有什么区别？

A： Playwright MCP 是"新建浏览器实例"，CDP Bridge MCP 是"连接已有浏览器"。前者丢失登录态，后者保留。

Q：支持哪些浏览器？

A： 目前支持 Chrome/Chromium 内核的浏览器（Chrome、Edge、Arc 等）。

Q：安全性如何？

A： 扩展需要申请多个权限才能正常工作，请只在可信环境中使用。

一句话总结

CDP Bridge MCP 让 AI Agent 连接你正在使用的真实浏览器，复用登录态、Cookie 和页面状态。

一行命令启动：

uvx cdp-bridge

GitHub：github.com/Unagi-cq/cdp-bridge-mcp