turbo-browser-mcp 是一款基于 Playwright 构建的 Model Context Protocol (MCP) 服务器，旨在解决浏览器自动化任务中 LLM Token 浪费及多轮交互延迟高的问题。该工具将传统 MCP 服务器中 25 至 33 个细粒度浏览器原语整合为 10 个高效批处理工具，支持增量 DOM 快照、单次调用完成 React/Shadow DOM/iframe 表单预填充、直接磁盘文件上传（避免 Base64 编码入上下文）、并行标签页会话、网络屏蔽预设以及默认的人机回环提交保护等功能。

性能突破：Token 节省高达 99.8%，速度提升 7 倍

基于本地无头 Chromium 环境及 OpenAI o200k_base 分词器的基准测试显示，turbo-browser-mcp 在多项关键指标上显著优于传统基线：

  • 密集 UI 快照：在处理包含 140 个按钮的 SaaS 控制台时，Token 占用从 HTML 的 18,654 降至 1,135，节省率达 93.9%；相较于完整 ARIA 树节省 68.2%。
  • 增量快照：点击后仅捕捉变更行，Token 消耗低至 56 tok，较完整 ARIA 重扫节省 98.4%，较 HTML 节省 99.7%。
  • 复杂表单填充：10 字段复杂表单的填写与验证从 11 轮交互缩减为 1 轮，执行时间从 574ms 降至 82ms，速度提升 7 倍；累计 Token 节省达 98.9%。
  • 文件上传：48 KiB PDF 上传通过磁盘路径引用而非 Base64 编码，Token 消耗从 44,728 降至 85，节省率高达 99.8%。
  • 并发操作：并发打开 6 个标签页从顺序执行的 998ms 优化至批处理的 420ms，速度提升 2.38 倍，并消除了 5 次提示重放。
  • 媒体屏蔽：在重度媒体加载场景下，通过屏蔽预设切断 100% 媒体带宽，加载速度提升 1.53 倍。

值得注意的是，消除表单填写中的 10 次往返交互，不仅节省了浏览器执行时间，更减少了智能体循环中约 71,800 个历史 Token 的重放，显著降低了 LLM 推理成本。

核心功能架构

1. 高效连接与会话隔离

支持 auto、cdp、persistent、launch 四种连接模式，可自动探测并重用已登录的浏览器会话，或启动干净的无头/有头实例。具备按标签页隔离能力，可在独立沙箱中并发管理多达 10 个 URL，支持独立的 Cookie、存储及视口模拟。

2. 智能 DOM 检查与跨边界遍历

inspect_compact 工具提供 interactive、forms、article 等多种快照模式。其核心优势在于能展平主框架、子 iframe 及 Shadow DOM，甚至通过初始化脚本挂钩技术，使初始化后关闭的 Shadow 根仍可被检查。支持 onlyChanged 模式仅输出变更元素，大幅降低 Token 负载。

3. 单次调用智能表单引擎

smart_fill_form 可在一次 MCP 调用中预填充整个表单，兼容文本、日期、范围滑块、复选框、单选组及 ARIA 组合框等。特别针对 React 控制组件，通过合成事件触发状态更新；支持 Gmail 撰写对话框及直接磁盘文件上传，无需将二进制数据加载至 LLM 上下文。

4. 批处理动作链

batch_actions 允许在一次调用中执行有序的 DOM 动作及嵌套表单步骤，支持错误继续策略，并在检测到提交保护时安全停止，有效减少多步交互中的延迟累积。

与主流 MCP 服务器对比

相较于 @playwright/mcp（25 个工具）和 chrome-devtools-mcp（33 个工具），turbo-browser-mcp 以 10 个精简工具实现了更低的静态 Token 开销（分别节省 23.2% 和 55.3%）。其主要差异点在于：

  • 增量快照：内置 onlyChanged 支持，而竞品每次均需返回完整 DOM 树。
  • Shadow DOM：支持关闭状态的 Shadow DOM 挂钩与遍历，竞品仅支持打开状态或标准 CDP 访问。
  • 表单效率：单调用完成复杂表单及文件上传，竞品需多轮单独调用。
  • 安全机制：默认启用人机回环提交保护，防止意外提交；竞品无此默认保护。
  • 功能侧重：turbo-browser-mcp 专注于 UI 自动化与抓取的最小化 Token 开销；chrome-devtools-mcp 则提供 Lighthouse、性能轨迹等深度诊断功能，两者可互补使用。

安全机制

系统默认启用 allowSubmit=false，拦截表单提交、发布、发送等潜在危险操作，除非显式授权。同时，通过 TURBO_BROWSER_SAVE_ROOT 环境变量严格限制文件读写路径，防止目录遍历、符号链接攻击及 UNC 路径风险，确保自动化过程的安全性。