cdp-bridge
It lets an MCP client automate and inspect real logged-in Chrome tabs through a browser extension, with optional token-isolated multi-account/multi-user contexts.
List open browser tabs with IDs, URLs, and titles.
Read the active tab as simplified HTML or plain text.
Execute JavaScript and capture results plus DOM changes.
Switch the MCP-side active tab or focus a Chrome tab visibly.
Run batches of extension/CDP commands.
Wait for JavaScript conditions to become truthy.
Navigate the active tab to a URL.
Take screenshots and save them as PNG files.
Operate multiple Chrome profiles/accounts by routing sessions through tokens.
Allows controlling a real browser session to interact with Bilibili, enabling reading pages, scanning content, executing JavaScript, taking screenshots, and performing automated operations on the platform.
Enables interaction with CSDN website via real browser control, including reading author backend data, scanning pages, and executing JavaScript automation.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@cdp-bridge scan the current browser page for key content"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
让一个 AI 工作台分别操作多个已登录的 Chrome 账号
CDP Bridge MCP · English

20 秒演示:两个本地测试账号打开相同的网址。蓝线和橙线标出演示请求各自的路径;两张订单页和读回的结果取自实际 MCP 测试。
快速安装 · 读出第一个标签页
准备一个用于试用的 Chrome Profile,在装有 Claude Code 和 uv 的电脑上打开项目终端。扩展可以读取和操作该 Profile 的页面,0.1.25 也会移除其中页面和子框架的 CSP 响应头。
下载 Chrome 扩展 ZIP · v0.1.25,解压到一个可以保留的文件夹。打开
chrome://extensions,开启 开发者模式,选择 加载已解压的扩展程序,选中解压后包含manifest.json的目录。在这个 Profile 打开一个普通网页。在项目终端执行下面的命令,然后在同一目录新开 Claude Code 会话,按提示启用项目的 MCP 连接。
claude mcp add --scope project --transport stdio cdp-bridge -- uvx cdp-bridge==0.1.25复制到 Claude Code:
列出当前浏览器标签页,告诉我标题。
看到刚才打开的网页标题就成功了。下图展示了一次真实 browser_get_tabs 返回中的一个标签页。如果列表为空,保持网页打开,等扩展自动重连后再问一次。

Related MCP server: YaviControl MCP Server
接着试双账号
先退出刚才的单账号 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 连接读取各自后台上的账号名和待处理订单数,分两行告诉我结果。
更多演示
系统架构
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数据流简述:
MCP 客户端通过 stdio(子进程)或 streamable-http(HTTP 端点)连接
cdp-bridge服务;在streamable-http模式下,客户端可通过Authorization: Bearer <token>指定自己的用户上下文。服务端的
Token Middleware负责提取 token,TokenManager负责按 token 隔离会话;同一个 token 下的 MCP 请求和浏览器扩展连接会被路由到同一个上下文。TMWebDriver 启动供浏览器扩展连接的 WebSocket(默认 :18765)和内部 HTTP fallback(默认 :18766);不同电脑上的用户、或同一台电脑上不同 Browser Profile 的扩展,都可以同时接入。
每个浏览器扩展在连接时会上报自己的 token 和已打开标签页(
ext_ws模式);服务端据此把不同 profile、不同账号、不同用户的真实浏览器页面隔离开来。当 MCP 工具被调用(如
browser_execute_js),服务端只会把 JS 代码发送到当前 token 对应的浏览器会话;扩展的 background.js 优先使用chrome.scripting.executeScript在页面 MAIN world 执行,若页面有 CSP 限制则自动降级为 CDPRuntime.evaluate。执行结果通过 WebSocket 返回服务端,再由 MCP 协议返回给对应客户端;因此可以同时操作同一平台的多个账号,也可以支持多台电脑上的多用户并发使用而互不干扰。
可用工具
MCP 服务当前暴露以下 12 个工具:
工具名 | 参数 | 说明 |
| 无 | 获取所有已连接的浏览器标签页,返回标签页 ID、URL 和标题列表,以及当前活动标签页 |
|
| 列出可见交互控件,返回角色、名称、状态、位置、短期引用及 |
|
| 对 |
|
| 扫描活动标签页内容。 |
|
| 在浏览器中执行 JavaScript 并捕获返回值及 DOM 变更 diff。 |
|
| 切换 MCP 侧的活动标签页(不改变用户在 Chrome 中看到的标签页),后续工具调用将作用于该标签页 |
|
| 将 Chrome 标签页置于前台并聚焦窗口,使标签页对用户可见。区别于 |
|
| 一次请求批量执行多个扩展/CDP 命令,适合需要复用 CDP 上下文的复杂操作链 |
|
| 轮询等待 JavaScript 条件表达式返回真值。 |
|
| 导航活动标签页到指定 URL |
|
| 对活动标签页截图,返回 base64 编码的 PNG 图片数据 |
|
| 将 |
语义操作流程:先调用 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。
配置 MCP
先确认电脑上已安装 uv。CDP Bridge MCP 通过 uvx cdp-bridge@latest 启动。
两种传输模式
CDP Bridge 支持两种 MCP 传输模式,可根据使用场景选择:
模式 | 原理 | 适用场景 |
| MCP 客户端以子进程启动服务,通过标准输入/输出通信 | Claude Desktop、Claude Code、Codex 等本地客户端 |
| 服务以独立 HTTP 进程运行,客户端通过 HTTP 请求连接 | 多客户端共享、Docker 部署、服务常驻 |
启动参数
参数 | 默认值 | 适用模式 | 说明 |
|
| 两种模式 | MCP 传输模式。可选 |
|
| 两种模式 | 浏览器扩展连接的 WebSocket 端口。无论使用 |
|
| 仅 | MCP HTTP 服务端口。只在 |
| 空 | 仅 | 允许接入的 token 白名单,多个 token 用英文逗号分隔;为空时接受任意 token。 |
--host | 127.0.0.1 | 仅 | 默认 |
注意:--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。
MCP 对比测评(V3)
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查看 V3 测试报告 和 V3 测评脚本。脚本运行时还会在同一目录生成 eval_results.json;默认不保存完整工具正文,避免把真实标签页或页面隐私写入结果,确需审计时可增加 --save-tool-output。
2026-08-09 的 V3 样例使用 cdp-bridge 0.1.23、Playwright MCP 0.0.79 和 deepseek-v4-pro,在 core 模式下对 3 个场景各重复 3 次,共执行 18 次任务。两侧任务通过率和平均质量均为 100% / 1.00。
下表依次列出“中位耗时 / 平均工具调用 / 工具成功率 / 中位总 Token”:
场景 | CDP Bridge | Playwright |
本地确定性内容提取 | 12.56s / 2.0 / 100.0% / 940 | 11.03s / 2.0 / 100.0% / 773 |
本地确定性交互 | 16.37s / 3.0 / 100.0% / 1,084 | 22.54s / 5.0 / 80.0% / 1,451 |
NumPy 外部页面 | 37.24s / 4.7 / 100.0% / 7,212 | 60.52s / 8.0 / 83.3% / 21,535 |
本次运行中,Playwright 在简单内容提取场景耗时和 Token 更低;CDP Bridge 在交互与外部页面场景使用了更少的工具调用和 Token,并取得更低的中位耗时与更高的工具成功率。以上是特定模型、网络和浏览器会话下的端到端结果,不代表通用性能结论;真实登录态与标签页场景属于诊断项,未计入本次核心质量排名。
MCP 对比测评(V2)
仓库提供了 V2 测评脚本,用相同的用户 query、LLM 和 MCP 工具调用循环,对比 CDP Bridge 与 Playwright MCP 的实际任务表现。测评记录以下指标:
任务成功率、答案质量分数
API 调用轮次、工具调用次数及工具成功率
输入/输出 Token 和总耗时
每一次工具调用的参数、耗时、返回字符数和错误信息
脚本位置:reports/V-002-2026-07-12/eval_mcp_compare_v2.py。运行完整测评前,需要准备浏览器扩展、CDP Bridge 服务、Playwright MCP、Anthropic 兼容 API,以及 ANTHROPIC_API_KEY:
export ANTHROPIC_API_KEY="你的 API Key"
export ANTHROPIC_BASE_URL="https://api.deepseek.com/anthropic" # 可选
export ANTHROPIC_MODEL="deepseek-v4-pro" # 可选
# 默认 3 个场景,每个场景重复 3 次
python reports/V-002-2026-07-12/eval_mcp_compare_v2.py
# 只测某个场景,或只测一侧
python reports/V-002-2026-07-12/eval_mcp_compare_v2.py --case numpy --repeats 3
python reports/V-002-2026-07-12/eval_mcp_compare_v2.py --cdp-only
# 只检查依赖并生成报告,不调用 LLM
python reports/V-002-2026-07-12/eval_mcp_compare_v2.py --preflight报告会写入 reports/V-002-2026-07-12/eval_compare_report.md。V2 的示例运行结果(2026-07-12、每个场景 1 次)如下,数值仅用于说明该次环境下的观测,不代表所有网络、浏览器登录态或模型配置:
场景 | CDP Bridge | Playwright | 观测 |
小红书首页首条内容 | 14.2s / 3 次工具调用 | 37.4s / 5 次工具调用 | CDP Bridge 更快、调用更少;页面内容受风控和登录态影响 |
菜鸟教程 NumPy 位运算 | 29.9s / 5 次调用 / 10,315 Token | 68.1s / 10 次调用 / 18,647 Token | CDP Bridge 在该场景耗时、调用次数和 Token 更低 |
当前标签页列表 | 8.8s / 1 次调用 | 4.4s / 1 次调用 | Playwright 更快;两侧浏览器会话中的标签页数量并不等价 |
测评中的“答案质量”是基于场景验收词的可解释启发式分数,不替代人工核验。CDP Bridge 连接用户的真实浏览器会话,而 Playwright 通常使用独立浏览器环境;两者的 Cookie、缓存、页面推荐流、网络和安全策略可能不同,因此该测评是端到端工作流参考,不是纯协议或浏览器引擎基准。
Token 与多用户隔离
streamable-http 模式下,服务端会按 token 隔离浏览器会话空间。
MCP 客户端通过 HTTP 请求头传 token:
Authorization: Bearer <token>浏览器扩展通过弹窗里的
Token字段传同一个 token客户端 token 和扩展 token 必须完全一致,这样服务端才能把它们路由到同一个用户上下文
如果扩展里没有填写 token,会自动使用默认值
__default__如果服务端没有配置
--tokens,任何 token 都可以接入;配置了--tokens后,只允许白名单中的 token在同一台电脑上,你可以让不同浏览器 Profile 使用不同 token,从而并行操作同一个平台的多个账号
在不同电脑上,你也可以让多个用户分别连接到同一个
streamable-http服务,并通过不同 token 实现隔离
标准配置
stdio 模式:
{
"mcpServers": {
"cdp-bridge": {
"command": "uvx",
"args": ["cdp-bridge@latest"]
}
}
}如果需要修改浏览器扩展连接的 WebSocket 端口,把 --ws-port 加到 args 里:
{
"mcpServers": {
"cdp-bridge": {
"command": "uvx",
"args": ["cdp-bridge@latest", "--ws-port", "18767"]
}
}
}streamable-http 模式:
先启动服务:
uvx cdp-bridge@latest --transport streamable-http --port 8000如果同时要修改浏览器扩展连接的 WebSocket 端口:
uvx cdp-bridge@latest --transport streamable-http --port 8000 --ws-port 18767再配置客户端连接:
{
"mcpServers": {
"cdp-bridge": {
"type": "streamableHttp",
"url": "http://127.0.0.1:8000/mcp"
}
}
}如果你启用了多用户隔离,客户端应显式携带 Bearer token:
{
"mcpServers": {
"cdp-bridge": {
"type": "streamableHttp",
"url": "http://127.0.0.1:8000/mcp",
"headers": {
"Authorization": "Bearer team_alice"
}
}
}
}此时浏览器扩展弹窗中的 Token 也要填写成 team_alice。
Claude Code
方式一:命令行添加
# stdio 模式
claude mcp add --transport stdio cdp-bridge -- uvx cdp-bridge==0.1.25
# streamable-http 模式(先启动服务,再注册)
claude mcp add --transport http cdp-bridge http://127.0.0.1:8000/mcp方式二:配置文件(推荐用于 streamable-http 模式)
在 ~/.claude.json 中添加 mcpServers 配置:
{
"mcpServers": {
"cdp-bridge": {
"type": "http",
"url": "http://127.0.0.1:8000/mcp"
}
}
}注意:使用配置文件方式时,需要先启动
cdp-bridge服务(uvx cdp-bridge@latest --transport streamable-http --port 8000 --ws-port 18765),然后重启 Claude Code。
Codex
# stdio 模式
codex mcp add cdp-bridge uvx cdp-bridge@latest
# streamable-http 模式
codex mcp add cdp-bridge --transport streamable-http --url http://127.0.0.1:8000/mcpopencode
在 ~/.config/opencode/opencode.json 里配置:
stdio 模式:
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"cdp-bridge": {
"type": "local",
"command": [
"uvx",
"cdp-bridge@latest"
],
"enabled": true
}
}
}streamable-http 模式:
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"cdp-bridge": {
"type": "remote",
"url": "http://127.0.0.1:8000/mcp",
"enabled": true
}
}
}OpenClaw
可以使用 OpenClaw CLI 写入 MCP 配置:
# stdio 模式
openclaw mcp set cdp-bridge '{"command":"uvx","args":["cdp-bridge@latest"]}'
# streamable-http 模式
openclaw mcp set cdp-bridge '{"transport":"streamable-http","url":"http://remoteip:8000/mcp"}'等价的 stdio 配置结构:
{
"mcp": {
"servers": {
"cdp-bridge": {
"command": "uvx",
"args": ["cdp-bridge@latest"]
}
}
}
}注意事项
本项目需要 Python 3.10 或更高版本。
浏览器扩展内置自动重连机制:首次连接失败后会持续探测 WebSocket 服务(每 ~5 秒),当 MCP 服务启动后会自动恢复连接。如果看到 ERR_CONNECTION_REFUSED,等待数秒即可自动恢复。
页面自动化会运行在你的真实浏览器会话中,请只连接你信任的 MCP 客户端。
致谢
本项目的浏览器插件和部分代码参考并来源于 GenericAgent。感谢原项目作者的开源工作。
Available Tools
12 toolsbrowser_actA
Click or fill one control returned by browser_observe.
Args: tab_id: Tab ID returned by browser_observe. page_revision: Revision returned by browser_observe. ref: Control reference returned by browser_observe. action: Either "click" or "fill". value: Text to enter for "fill".
References are single-use and expire after 60 seconds. A stale result means the page or target changed; call browser_observe again.
Inputs: ref (required), action (required), tab_id (required), page_revision (required), +1 more. Returns: result
browser_batchA
Run multiple extension/CDP commands in one request.
Args: commands: Command objects supported by the extension, such as {"cmd":"cdp","method":"DOM.getDocument","params":{"depth":1}}. tab_id: Optional tab ID inherited by commands that omit tabId. timeout: Seconds to wait for the batch result.
Inputs: commands (required), tab_id, timeout. Returns: result
browser_execute_jsA
Execute JavaScript in the browser and capture results plus DOM changes.
Args: script: JavaScript code to execute (or JSON command for CDP operations). switch_tab_id: Switch to this tab before executing. no_monitor: Skip DOM change monitoring (faster, less info).
Inputs: script (required), no_monitor, switch_tab_id. Returns: result
browser_focus_tabA
Bring a Chrome tab to the foreground: activate the tab AND focus its window.
Unlike browser_switch_tab (which only changes the MCP-side active session without touching the visible Chrome UI), this actually makes the tab visible to the user. Use this when the user can't find the tab the agent is working on (e.g. across many windows / Spaces / minimized windows).
Goes through chrome.tabs.update + chrome.windows.update (extension-native APIs), avoiding the chrome.debugger CDP "Not allowed" restriction on Target.activateTarget.
Args: tab_id: The tab ID to focus (from browser_get_tabs).
Inputs: tab_id (required). Returns: result
browser_get_tabsA
Get all open browser tabs with their IDs, URLs, and titles.
Inputs: no named parameters. Returns: result
browser_observeA
List visible interactive controls on a tab with short-lived references.
Args: tab_id: Tab to observe. Uses the active MCP tab if empty. limit: Maximum controls to return, up to 150.
Returns a page_revision and control refs for browser_act. Observe again after an action, navigation, or a stale-reference response.
Inputs: limit, tab_id. Returns: result
browser_save_imageA
Save base64 screenshot data to PNG file.
Args: screenshot_json_str_or_file: JSON output from browser_screenshot tool, or path to a JSON file containing the screenshot data. output_path: Output PNG file path or directory. Behavior: - Existing directory: save as {directory}/screenshot_{timestamp}.png - File path with existing parent dir: save directly to that file - File path with non-existing parent dir: return error - Empty/not provided: auto-generate based on input path or timestamp
Returns: JSON with status, saved_path, and size_bytes.
Inputs: screenshot_json_str_or_file (required), output_path. Returns: result
browser_scanA
Get simplified HTML content of the active tab plus tab list. The HTML is optimized for LLM consumption (stripped of scripts, styles, invisible elements).
Args: tabs_only: Only return tab list without page content (saves tokens). switch_tab_id: Switch to this tab before scanning. text_only: Return plain text instead of simplified HTML.
Inputs: tabs_only, text_only, switch_tab_id. Returns: result
browser_screenshotA
Take a screenshot of the active tab (returns base64 PNG).
Args: tab_id: Optional tab ID to screenshot. Uses active tab if empty.
Inputs: tab_id. Returns: result
browser_switch_tabA
Switch the active MCP browser tab without changing the visible Chrome tab.
Args: tab_id: The tab ID to switch to (from browser_get_tabs).
Inputs: tab_id (required). Returns: result
browser_waitA
Wait until JavaScript condition returns a truthy value.
Args: condition_js: JavaScript expression or script. The return value is tested for truthiness. timeout: Maximum seconds to wait. interval: Seconds between checks. switch_tab_id: Optional tab ID to make active before waiting.
Inputs: condition_js (required), timeout, interval, switch_tab_id. Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 12 tools
Each tool has a distinct role, and the descriptions explicitly differentiate the tricky pairs (browser_switch_tab vs browser_focus_tab, browser_scan vs browser_observe). Remaining overlap: browser_execute_js and browser_batch both accept raw CDP commands, which could cause misselection for advanced operations.
Every tool follows the same browser_<verb>_<noun> pattern (browser_get_tabs, browser_save_image, browser_wait), with only minor noun-less variants like browser_scan and browser_act that still fit the convention. Fully predictable naming.
12 tools is well within the sweet spot for a browser automation bridge. Each tool covers a distinct capability layer (perception, action, navigation, tab management, capture, escape hatches) and none feel redundant.
Core observe/act/navigate/wait/screenshot/tab workflows are fully covered, including ref-staleness handling and raw CDP escape hatches. Minor gaps: no tab create/close, and no keyboard press, scroll, or hover actions beyond click/fill, though these are workable via browser_execute_js.
Maintenance
Related MCP Connectors
Real Chrome for coding agents over MCP: browse, replay playbooks, human takeover, HIPAA & BAA.
Web scraping, browser automation, screenshots and AI data extraction for AI agents via MCP.
Let your AI agent operate any website through a real, logged-in browser session.
Browser MCP for logged-in tasks. Uses your Chrome — credentials stay local. Zero-token replay.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceEnables MCP clients to control and interact with the user's real Chrome browser session, leveraging existing logins, cookies, and extensions for AI-driven automation.5MIT
- AlicenseNot gradedqualityDmaintenanceEnables AI agents to control your existing Chrome browser via MCP, using your logged-in sessions for automation on authenticated sites. Provides high-level browser tools plus raw CDP and Chrome API access.MIT
- AlicenseNot gradedqualityBmaintenanceEnables AI agents to drive a live, persistent self-hosted Chromium session over MCP, running browser actions via Playwright/CDP, capturing page snapshots, screenshots and videos, and managing uploads and downloads in the same tabs and signed-in accounts a human user can take over at any time.Apache 2.0
- AlicenseNot gradedqualityBmaintenanceEnables AI agents to drive a local Chromium browser through MCP, with persistent sessions, one-click registration across supported AI apps, and CDP/Playwright-based control.MIT