SuperAPI AI 工具集

cdp-bridge-mcp-browser-control

智能体与模型

查看项目

更新于 10-15 22:33

技能介绍

用途:CDP Bridge MCP 是连接 LLM 客户端与真实活动浏览器会话的 MCP 服务器,借助 CDP 和配套浏览器扩展工作。与无头自动化工具不同,它连接你已打开、已登录的标签页,复用登录会话与 Cookie,无需重新认证或迁移 Cookie,并在当前浏览器状态上操作。

主要能力:提供 browser_get_tabs(列出标签页 URL 与标题)、browser_scan(以简化 HTML 或纯文本提取页面,去除 script/style/svg 和隐藏元素,img 转为 [Image: alt])、browser_execute_js(在活动标签执行 JS,优先 chrome.scripting,被 CSP 阻止时回退到 CDP Runtime.evaluate)、browser_switch_tab、browser_batch(原子执行多条命令)、browser_wait(轮询 JS 条件直到为真或超时)、browser_navigate、browser_screenshot(base64 PNG)、browser_cookies(读取当前域 Cookie)。

使用方式:通过 PyPI 安装并以 uvx 运行,默认 stdio 模式:uvx cdp-bridge@latest;多客户端场景用 HTTP:uvx cdp-bridge@latest --transport streamable-http --port 8000。在 chrome://extensions/ 开启开发者模式,加载仓库中的 src/cdp_bridge/tmwd_cdp_bridge 文件夹;扩展会自动连接 127.0.0.1:18765(WebSocket),未启动时约每 5 秒重试。客户端配置:stdio 用 command=uvx、args=["cdp-bridge@latest"];streamable-http 用 type=streamableHttp、url=http://127.0.0.1:8000/mcp。Claude Code 用 claude mcp add cdp-bridge uvx cdp-bridge@latest;Codex 用 codex mcp add cdp-bridge uvx cdp-bridge@latest。

适用场景:从已登录站点提取文章内容、轮询仪表盘指标、在已认证会话中填写表单,以及需要保留登录状态与当前页面状态的 LLM 驱动交互。

限制:需要 Python 3.10+、Chrome 或 Chromium 系浏览器,并手动加载开发者模式扩展;需能访问 127.0.0.1:18765 与 18766。标签 ID 基于会话,扩展重载、浏览器重启或 WebSocket 重连后会重置,操作前应重新调用 browser_get_tabs。CSP 可能阻止脚本注入(自动回退 CDP,两者都失败时需检查控制台并包裹函数或避免受限 API)。browser_scan 可能产生较高 token 消耗,可改用 text 格式或先用 JS 缩小 DOM 范围。扩展首次加载显示 ERR_CONNECTION_REFUSED 属正常。收费、价格与更多平台支持暂未提供。