AgentDeskAI/browser-tools-mcp
Monitor browser logs directly from Cursor and other MCP compatible IDEs.
它解决的问题
在调试 Web 应用时,AI 编码代理通常通过 CDP 驱动一个全新的自动化浏览器,迫使你重新创建登录状态,并丢失你实际查看页面的上下文。BrowserTools MCP 通过连接到你的真实 Chrome 会话(已经登录到你的应用的会话)来解决这个问题,并将你在 DevTools 中看到的相同遥测数据(控制台、网络、截图、Lighthouse)流式传输到任何兼容 MCP 的客户端,如 Cursor、Claude Code 或 Windsurf。这使代理能够调试你打开的精确页面,同时保持你的身份验证和状态不变。
工作原理
该工具由两部分组成:一个 MCP 服务器(通过 npx 安装)和一个 Chrome 扩展。你将扩展加载到 Chrome 中,在你关心的页面上打开 DevTools,捕获即开始。扩展将控制台输出、网络请求、截图和 Lighthouse 审计结果推送到一个仅绑定到回环地址(127.0.0.1)并需要每次运行的身份验证令牌的本地连接器。MCP 服务器将这些作为工具(getConsoleLogs、getNetworkLogs、takeScreenshot、runAccessibilityAudit 等)暴露给 AI 代理调用。为了保持响应较小,日志返回时带有限制和过滤器,而大型负载(完整控制台历史、HAR 文件、高分辨率截图)则作为 MCP 资源暴露,代理可按需获取。隐私通过清除凭据(Authorization、Cookie、JWT、云密钥)并拒绝审计私有网络地址(除非明确允许)来处理。
适用人群
使用 AI 编码代理(Cursor、Claude Code、Windsurf、Cline、Zed、Gemini CLI)的开发者,他们需要代理调试在 Chrome 中打开的实时应用——尤其是当应用需要登录或复杂状态,而这些在单独浏览器中重建很痛苦时。它也有助于开发期间的性能、可访问性和 SEO 审计。
亮点
- 与你现有的 Chrome 会话配合使用——保持登录状态并停留在同一页面。
- 支持多个标签页,遥测数据按标签页归属,并可针对特定标签页。
- 包含 Lighthouse 审计,涵盖性能、可访问性、SEO 和最佳实践。
- 通过限制、过滤器和用于大数据量的 MCP 资源保持上下文大小较小。
- 注重隐私:仅回环绑定、身份验证令牌、凭据清除和可选的 cookie 访问。
- 2.0 版本是一次重写,采用单一进程、无未认证服务器,并包含真正的测试套件。
相关
- 项目
- 项目
- 项目
- 项目
- 项目