BrowserTools MCP

BrowserTools MCP

BrowserTools MCP 是一款先进的浏览器监控和交互工具,允许 AI 代理和兼容编辑器通过 Chrome 扩展和本地服务器捕获、分析和审计浏览器数据。它为语言模型提供了对浏览器状态的实时访问,使代理具备更强的上下文感知能力,并能够执行各种自动化的浏览器审计和调试任务——所有数据均未离开您的机器。

Author: AgentDeskAI


查看协议

什么是 BrowserTools MCP?

BrowserTools MCP 是一个连接您的浏览器和 AI 驱动的应用程序或编辑器的系统。通过利用 Chrome 扩展、本地 NodeJS 服务器和 MCP 服务器,它为语言模型和编码代理提供访问浏览器日志、DOM 细节、屏幕截图、网络请求的能力,并进行无障碍性、性能、SEO 和最佳实践的自动化审计。它完全在您的机器上运行,以保护隐私。

如何配置

  1. 安装 Chrome 扩展:发布页面 下载并添加 BrowserTools MCP Chrome 扩展到您的浏览器。
  2. 设置 MCP 服务器: 在您的 IDE 或 MCP 兼容客户端中运行:
    npx @agentdeskai/browser-tools-mcp@latest
  3. 运行本地 Node 服务器: 打开一个独立的终端并执行:
    npx @agentdeskai/browser-tools-server@latest
  4. 启用扩展面板: 打开 Chrome DevTools,导航到 BrowserToolsMCP 面板,确保它处于活动状态。
  5. 检查连接性: 确保只打开一个 DevTools 面板,如果有必要,重新启动浏览器和服务器以排除故障。
  6. 配置选项: 使用扩展的选项设置屏幕截图文件夹、令牌/截断限制以及隐私偏好。

如何使用

  • 配置完成且所有组件正在运行时,使用您的 MCP 兼容编辑器或代理(如 Cursor)来触发审计、捕获日志、屏幕截图或与页面元素交互。
  • 常见用途包括请求 AI 代理进行无障碍性审计、性能分析、SEO 审查或调试代码——直接针对您浏览器中当前打开的网页。
  • 结果将在您的 IDE 或代理环境中显示,实时来源于您的浏览器会话,并可以使用自然语言或函数调用来提示。

主要特点

  • 对浏览器日志、网络活动和屏幕截图的无缝实时访问,适用于 AI 工具。
  • 使用 Lighthouse 集成进行无障碍(WCAG)、性能、SEO、最佳实践和 NextJS 特定内容的自动化审计。
  • 本地优先: 所有浏览器数据在您自己的机器上处理和存储——无信息发送给第三方。
  • 调试器和审计模式,能通过一个命令协调一系列深入检查。
  • 适合代理工作流程的结构化 JSON 结果。
  • 灵活的配置和强大的跨平台连接性。
  • 通过扩展面板一键管理日志和屏幕截图。

使用案例

  • 自动化无障碍性验证: 确保您团队构建的每个页面都符合无障碍性标准,通过编程在开发过程中运行审计。
  • 性能调优: 在发布代码之前检测瓶颈和未优化资源,并在您的 IDE 中提供可行的建议。
  • SEO 和最佳实践分析: 即时审查页面 SEO 和代码最佳实践,以最大化搜索可见性和网络健康。
  • 浏览器调试: 在测试用例或错误再现期间捕获日志、网络跟踪和屏幕截图,并分享丰富的上下文报告。
  • 持续代码质量: 通过在 MCP 兼容工具中编写自动检查,将审计整合到 CI/CD 过程中。

常见问题

问:BrowserTools MCP 会将任何浏览器数据发送到外部服务器吗?
不会。所有日志、屏幕截图和诊断数据都存储在本地,绝不会传输到第三方服务。隐私和安全得到了严格维护。

问:我可以与 BrowserTools MCP 一起使用哪些 AI 编辑器或代理?
任何支持模型上下文协议 (MCP) 的编辑器或工具,例如 Cursor、Claude Desktop、Zed 或 Cline,都可以利用 BrowserTools MCP 的能力。

问:我遇到了连接问题——我应该检查什么?
首先,确保 NodeJS 服务器和 MCP 服务器都在运行,并且只有一个 Chrome DevTools 面板处于活动状态。如果问题仍然存在,请彻底关闭并重启 Chrome 和两个服务器,然后重新打开 DevTools。