Browser Harness

项目简介

Browser Harness 是一个直接构建在 CDP 上的轻量级自愈式工具。它通过一个可编辑的 CDP WebSocket 把 LLM 连接到真实浏览器，代理会在工作中编写缺失的辅助函数，因此工具随每次任务改进。它可运行在本地 Chrome、隐身浏览器或 Browser Use Box 上，并为 MCP 客户端提供 MCP 服务器。

核心功能

• 直接构建在 CDP 上的轻量级自愈式工具；通过一个可编辑的 CDP WebSocket 把 LLM 直接连接到真实浏览器；代理在任务中途于本地工作区编写缺失的辅助函数，使工具随每次任务改进；受保护的核心源代码与代理编写的可复用辅助函数分开存放；MCP 服务器 browser-harness-mcp 通过 stdio 将浏览器控制辅助函数暴露为 MCP 工具；可运行在本地 Chrome、隐身浏览器，或在自己的 Browser Use Box 上 24/7 运行。

适用场景

• 完成浏览器任务，例如打开个人资料、找到最近 20 条视频帖子并下载；使用本地浏览器处理已登录的个人浏览器工作；通过 Browser Use Cloud 以实时预览、代理、隐身和验证码处理等功能并行扩展多个浏览器；从 Claude Code、Devin、Cursor 等 MCP 客户端驱动浏览器，而无需编写第二层 CDP。

快速开始

• 把提供的设置提示粘贴到 Claude Code 或 Codex；使用 uv 和 Python 3.12 将 browser-harness 安装或升级到最新稳定版；通过 browser-harness skill 注册技能并连接到浏览器；首次设置时在 Chrome 远程调试检查页面勾选复选框，让代理可以连接浏览器；如果设置或连接失败，请按照 install.md 操作。

采用前须知

• 许可证：MIT。在使用、修改或分发项目前，请确认其具体条款。