by Unagi-cq
Let one AI workspace operate multiple signed-in Chrome accounts. Route each MCP request to its own browser profile through a self-hosted bridge.
# Add to your Claude Code skills
git clone https://github.com/Unagi-cq/cdp-bridge-mcpGuides for using mcp servers skills like cdp-bridge-mcp.
See how cdp-bridge-mcp compares with popular alternatives.
cdp-bridge-mcp is an open-source mcp servers skill for AI coding assistants such as Claude Code, Codex CLI, and ChatGPT, built by Unagi-cq. Let one AI workspace operate multiple signed-in Chrome accounts. Route each MCP request to its own browser profile through a self-hosted bridge. It has 307 GitHub stars.
cdp-bridge-mcp's catalog security scan is still queued. You can run an instant dependency and prompt-injection check now with the "Scan for vulnerabilities" button above.
Clone the repository with "git clone https://github.com/Unagi-cq/cdp-bridge-mcp" and add it to your Claude Code skills directory (see the Installation section above).
cdp-bridge-mcp is primarily written in Python. It is open-source under Unagi-cq on GitHub, so you can review or fork the full source.
Yes. SkillsLLM lists many other MCP Servers skills you can browse and compare side by side. Open the MCP Servers category from the badge at the top of this page, or use the Related Skills and comparison links further down to weigh cdp-bridge-mcp against similar tools.
No comments yet. Be the first to share your thoughts!
Top skills in this category by stars
Available after the catalog security scan passes.
⚠️ Third-Party Software Notice
This skill is third-party open-source software developed and hosted independently on GitHub. SkillsLLM lists this project for discovery and does not control or maintain the underlying repository.
Any security checks, ratings, or warnings displayed by SkillsLLM are automated and limited in scope. They do not constitute a security certification or guarantee that the software is safe, error-free, or free from malicious code, vulnerabilities, compromised dependencies, or prompt-injection risks.
Review the source code, permissions, dependencies, and configuration before installing or running any third-party skill. Use is at your own risk. To the maximum extent permitted by applicable law, SkillsLLM is not liable for losses arising from third-party software.
The deep catalog scan for this skill is still queued. Run an instant dependency check now instead.
CDP Bridge MCP · English

20 秒演示:两个本地测试账号打开相同的网址。蓝线和橙线标出演示请求各自的路径;两张订单页和读回的结果取自实际 MCP 测试。
chrome://extensions,开启 开发者模式,选择 加载已解压的扩展程序,选中解压后包含 manifest.json 的目录。在这个 Profile 打开一个普通网页。claude mcp add --scope project --transport stdio cdp-bridge -- uvx cdp-bridge==0.1.25
复制到 Claude Code:
列出当前浏览器标签页,告诉我标题。
看到刚才打开的网页标题就成功了。下图展示了一次真实 browser_get_tabs 返回中的一个标签页。如果列表为空,保持网页打开,等扩展自动重连后再问一次。

先退出刚才的单账号 Claude Code 会话。在两个 Chrome Profile 里分别加载扩展,用不同测试账号登录同一个网站。在两个扩展弹窗中把 Port 都设为 19245,Token 分别填 north、south,点击保存连接配置。
在一个终端启动本地服务并保持运行。
uvx cdp-bridge==0.1.25 --transport streamable-http --port 19240 --ws-port 19245 --tokens north,south
在另一个终端进入新的项目目录,添加两条连接。在该目录启动 Claude Code,启用这两项服务。
claude mcp add --scope project --transport http north http://127.0.0.1:19240/mcp --header "Authorization: Bearer north"
claude mcp add --scope project --transport http south http://127.0.0.1:19240/mcp --header "Authorization: Bearer south"
分别用 north 和 south 连接读取各自后台上的账号名和待处理订单数,分两行告诉我结果。
| 单台电脑多个小红书账号同时操作 | 查询小红书平台 Anthropic 最新动态 | 读取 CSDN 网站作者后台数据分析 |
|---|---|---|
| 观看视频 | 观看视频 | 观看视频 |
graph TB
subgraph Client["🖥️ MCP 客户端 / Agent"]
ClientA["客户端 A<br/>Bearer token_a"]
ClientB["客户端 B<br/>Bearer token_b"]
end
subgraph Server["⚙️ cdp-bridge MCP 服务 (Python)"]
FastMCP["FastMCP<br/>stdio / streamable-http"]
Middleware["Token Middleware<br/>Authorization Bearer"]
TokenManager["TokenManager<br/>按 token 隔离用户上下文"]
TMWD["TMWebDriver<br/>会话管理器"]
WS["Extension WebSocket<br/>默认 127.0.0.1:18765"]
HTTP["Extension HTTP Fallback<br/>默认 127.0.0.1:18766"]
FastMCP --- Middleware
Middleware --- TokenManager
TokenManager --- TMWD
TMWD --- WS
TMWD --- HTTP
end
subgraph DeviceA["💻 同一台电脑(多个 Browser Profile)"]
ProfileA1["Profile A1<br/>账号 A / token_a"]
ProfileA2["Profile A2<br/>账号 B / token_b"]
end
subgraph DeviceB["🧑💻 另一台电脑(另一位用户)"]
ProfileB1["Profile B1<br/>账号 C / token_c"]
end
subgraph BrowserRuntime["🌐 浏览器扩展与页面"]
BG["background.js<br/>Service Worker"]
CT["content.js<br/>Content Script"]
Tabs["浏览器标签页<br/>真实登录态 / 多账号页面"]
end
ClientA <-->|"MCP 协议\nstreamable-http / stdio"| FastMCP
ClientB <-->|"MCP 协议\nstreamable-http"| FastMCP
ProfileA1 <-->|"扩展连接\ntoken_a"| WS
ProfileA2 <-->|"扩展连接\ntoken_b"| WS
ProfileB1 <-->|"扩展连接\ntoken_c"| WS
WS <-->|"WebSocket (ext_ws)"| BG
HTTP <-->|"HTTP 长轮询"| BG
BG <-->|"chrome.scripting<br/>CDP Runtime.evaluate"| Tabs
BG <-->|"chrome.runtime.sendMessage"| CT
CT -->|"DOM 访问"| Tabs
数据流简述:
cdp-bridge 服务;在 streamable-http 模式下,客户端可通过 Authorization: Bearer <token> 指定自己的用户上下文。Token Middleware 负责提取 token,TokenManager 负责按 token 隔离会话;同一个 token 下的 MCP 请求和浏览器扩展连接会被路由到同一个上下文。ext_ws 模式);服务端据此把不同 profile、不同账号、不同用户的真实浏览器页面隔离开来。browser_execute_js),服务端只会把 JS 代码发送到当前 token 对应的浏览器会话;扩展的 background.js 优先使用 chrome.scripting.executeScript 在页面 MAIN world 执行,若页面有 CSP 限制则自动降级为 CDP Runtime.evaluate。MCP 服务当前暴露以下 12 个工具:
| 工具名 | 参数 | 说明 |
|---|---|---|
browser_get_tabs |
无 | 获取所有已连接的浏览器标签页,返回标签页 ID、URL 和标题列表,以及当前活动标签页 |
browser_observe |
tab_id (str), limit (int) |
列出可见交互控件,返回角色、名称、状态、位置、短期引用及 page_revision。默认观察 MCP 当前标签页;最多返回 150 个控件 |
browser_act |
tab_id (str), page_revision (str), ref (str), action (str), value (str) |
对 browser_observe 返回的控件执行 click 或 fill,返回操作结果与页面文本变化。引用只能使用一次,有效期 60 秒;失效后重新观察 |
browser_scan |
tabs_only (bool), switch_tab_id (str), text_only (bool) |
扫描活动标签页内容。tabs_only 仅返回标签页列表节省 token;text_only 返回纯文本而非简化 HTML;switch_tab_id 在扫描前先切换到指定标签页 |
browser_execute_js |
script (str, 必填), switch_tab_id (str), no_monitor (bool) |
在浏览器中执行 JavaScript 并捕获返回值及 DOM 变更 diff。no_monitor 跳过 DOM 监控可提速;switch_tab_id 先切换到目标标签页再执行 |
browser_switch_tab |
tab_id (str, 必填) |
切换 MCP 侧的活动标签页(不改变用户在 Chrome 中看到的标签页),后续工具调用将作用于该标签页 |
browser_focus_tab |
tab_id (str, 必填) |
将 Chrome 标签页置于前台并聚焦窗口,使标签页对用户可见。区别于 browser_switch_tab(仅切换 MCP 侧会话),此工具会实际激活 Chrome 窗口和标签页 |
browser_batch |
commands (list[dict], 必填), tab_id (str), timeout (float) |
一次请求批量执行多个扩展/CDP 命令,适合需要复用 CDP 上下文的复杂操作链 |
browser_wait |
condition_js (str, 必填), timeout (float), interval (float), switch_tab_id (str) |
轮询等待 JavaScript 条件表达式返回真值。timeout 最长等待秒数(默认 10);interval 检查间隔秒数(默认 0.5) |
browser_navigate |
url (str, 必填) |
导航活动标签页到指定 URL |
browser_screenshot |
tab_id (str) |
对活动标签页截图,返回 base64 编码的 PNG 图片数据 |
browser_save_image |
screenshot_json_str_or_file (str, 必填), output_path (str) |
将 browser_screenshot 返回的 base64 截图数据保存为本地 PNG 文件。screenshot_json_str_or_file 为截图 JSON 字符串或 JSON 文件路径;output_path 为输出路径或目录 |
语义操作流程:先调用 browser_observe,从结果中选择控件的 ref,再把同一结果中的 tab_id 和 page_revision 传给 browser_act。操作后重新观察。当前版本支持页面主文档与开放的 Shadow DOM;iframe 内的控件尚未包含在结果中。
在 Chrome 或其他 Chromium 浏览器中加载:
chrome://extensions/。src/cdp_bridge/tmwd_cdp_bridge 文件夹。默认情况下,扩展会连接本地 WebSocket 服务 127.0.0.1:18765。
扩展弹窗里可以修改连接配置:
Bridge Host:可填写 127.0.0.1、localhost 或域名。填写域名时可以不填端口,例如 bridge.example.com。Port:WebSocket 端口。使用本地默认配置时是 18765;如果 MCP 启动时使用了 --ws-port,这里需要填同一个端口。域名接入并且服务走默认 WebSocket 端口时,可以留空。Token:streamable-http 多用户模式下用于把浏览器扩展和 MCP 客户端绑定到同一个用户上下文。留空时扩展会自动写入默认值 __default__。如果你使用 Bearer token 访问远端 MCP 服务,这里必须填写和客户端完全一致的 token。先确认电脑上已安装 uv。CDP Bridge MCP 通过 uvx cdp-bridge@latest 启动。
CDP Bridge 支持两种 MCP 传输模式,可根据使用场景选择:
| 模式 | 原理 | 适用场景 |
|---|---|---|
stdio(默认) |
MCP 客户端以子进程启动服务,通过标准输入/输出通信 | Claude Desktop、Claude Code、Codex 等本地客户端 |
streamable-http |
服务以独立 HTTP 进程运行,客户端通过 HTTP 请求连接 | 多客户端共享、Docker 部署、服务常驻 |
| 参数 | 默认值 | 适用模式 | 说明 |
|---|---|---|---|
--transport |
stdio |
两种模式 | MCP 传输模式。可选 stdio 或 streamable-http。 |
--ws-port |
18765 |
两种模式 | 浏览器扩展连接的 WebSocket 端口。无论使用 stdio 还是 streamable-http,都可以配置。 |
--port |
8000 |
仅 streamable-http |
MCP HTTP 服务端口。只在 --transport streamable-http 时使用,客户端连接地址是 http://127.0.0.1:<port>/mcp。 |
--tokens |
空 | 仅 streamable-http |
允许接入的 token 白名单,多个 token 用英文逗号分隔;为空时接受任意 token。 |
| --host | 127.0.0.1 | 仅 streamable-http |
默认streamable-http启动时监听的是127.0.0.1,无法进行远程访问。通过增加该参数,可指定监听的ip,可配置为0.0.0.0监听所有网卡的ip。 |
注意:--ws-port 是浏览器扩展连接后端的端口;--port 是 MCP 客户端连接后端的 HTTP 端口。两者不是同一个端口。
# stdio 模式(默认)
uvx cdp-bridge@latest
# stdio 模式,指定 WebSocket 端口
uvx cdp-bridge@latest --ws-port 18767
# streamable-http 模式,指定 MCP HTTP 端口
uvx cdp-bridge@latest --transport streamable-http --port 8000
# streamable-http 模式,同时指定 MCP HTTP 端口和浏览器扩展 WebSocket 端口
uvx cdp-bridge@latest --transport streamable-http --port 8000 --ws-port 18767
# streamable-http 模式,只允许指定 token 接入
uvx cdp-bridge@latest --transport streamable-http --port 8000 --tokens "team_alice,team_bob"
# streamable-http 模式,同时指定 MCP HTTP 端口和监听的ip,远程机器可通过172.25.240.1:8000访问运行的MCP Server
uvx cdp-bridge@latest --transport streamable-http --host 172.25.240.1 --port 8000
# 也可以通过环境变量传入 token 白名单
CDP_BRIDGE_TOKENS="team_alice,team_bob" uvx cdp-bridge@latest --transport streamable-http --port 8000
不传 --transport 时默认使用 stdio。stdio 模式没有 MCP HTTP 端口;streamable-http 模式的 MCP 服务地址为 http://127.0.0.1:<port>/mcp。
V3 修正了 V2 “只要模型返回非空文本就算成功”的统计问题,改用场景级验收规则,并把场景分为确定性核心对比、真实登录态诊断和标签页诊断。核心对比会记录通过率、质量、工具成功率、API 轮次、Token 和耗时,同时生成 Markdown 报告与结构化 JSON。默认测试当前工作区源码,并固定 Playwright MCP 版本,避免 latest 漂移。
export ANTHROPIC_API_KEY="你的 API Key"
export ANTHROPIC_BASE_URL="https://api.deepseek.com/anthropic" # 可选
export ANTHROPIC_MODEL="deepseek-v4-pro" # 可选
# 只做前置检查和本地构建,不调用 LLM
uv run python reports/V-003-2026-08-09/eval_mcp_compare_v3.py --preflight --build-check
# 核心对比,默认每个场景重复 3 次
uv run python reports/V-003-2026-08-09/eval_mcp_compare_v3.py --repeats 3
# 加入真实登录态和标签页诊断场景
uv run python reports/V-003-2026-08-09/eval_mcp_compare_v3.py --suite all --repeats 3