Scalebrowser

Scalebrowser MCP

你的 Agent 被拦截、卡在登录页面，或放弃处理验证码了吗？ Scalebrowser 为每个 AI Agent 提供独立的浏览器，拥有持久化身份，并在你自己的机器上运行，而不是在供应商的云端。它会保持登录状态、处理验证码、像人一样输入，而且你随时可以接管。

此代码仓库通过 MCP 将该浏览器连接到你的 Agent：包含文档所涵盖的每个客户端的可复制配置、小型 stdio 桥接程序，以及可运行的 SDK 示例。

开始之前

• Windows 10 或 11、64 位，并配备真实 GPU。 Scalebrowser 是一款在你的机器上运行的桌面应用。它没有托管模式。
• 拥有有效套餐的 Scalebrowser 账户。 可通过 7 天试用开始，包含一个浏览器。需要预先提供付款方式。套餐和价格

免费使用，无需账户： scalebrowser.net/check 用于测量当前浏览器在外部看来是什么样；scalebrowser.net/ai-agent-check 用于测量你的自动化工具如何使用它。让你的 Agent 访问第二个页面，看看网站能获取哪些信息。

五分钟快速上手

1. 在 scalebrowser.net 登录，打开 Download，然后运行安装程序。它会为当前用户安装，无需管理员权限。首次运行时 SmartScreen 会发出警告：选择 More info，然后选择 Run anyway。

2. 启动应用并点击 Sign in。随后应用会下载并验证浏览器引擎；必须完成此步骤后，才能启动任何配置文件。

3. 从 Settings, General, Connect an agent 复制 API 令牌。

4. 连接你的 Agent。对于 Claude Code，只需运行一条命令：

   claude mcp add --transport http scalebrowser http://127.0.0.1:8787/v1/mcp \
     --header "Authorization: Bearer $SCALEBROWSER_TOKEN"
   

5. 向它提出请求：

   在 Scalebrowser 配置文件中打开 news.ycombinator.com，阅读首页，并告诉我评论数最多的三条新闻。

Agent 会获取租约，预留一个配置文件并启动其浏览器，然后打开页面、读取页面的文本映射并作出回答。接着让它释放该配置文件。

连接你的客户端

以下每个文件都是官方文档中的配置，可直接复制。将 <token> 替换为你的 API 令牌，并将 <you> 替换为你的 Windows 用户名。每个文件的存放位置，以及两种会导致失败却不报错的写法，见 clients/README.md。

客户端	配置
Claude Code	claude-code.mcp.json、上方的命令，或插件
Claude 桌面应用	claude-desktop.json
Cursor	cursor.mcp.json
Codex	codex.config.toml
VS Code 中的 GitHub Copilot	github-copilot.mcp.json
Antigravity	antigravity.mcp_config.json
WSL 中的 Claude Code	wsl-claude-code.json
网页版 Claude、Grok、ChatGPT 和其他云端聊天服务	无需文件：它们通过远程访问连接到你的机器

Agent 能获得什么

Agent 通过页面的文本映射操作，并使用引用定位元素。它只查看一次页面，之后只查看发生变化的部分。在同一页面上执行 75 多个步骤时，与 Playwright MCP 相比，模型 token 消耗可减少 11 倍。

• 登录： credential_fill 使用配置文件中保存的登录信息登录，credential_new 使用 Scalebrowser 生成并保存的密码注册。Agent 不会看到密码。
• 确认码： read_inbox 读取发送到与配置文件绑定的地址的确认码，inbox_open_link 则打开消息中的链接。
• 验证挑战： press_and_hold、click 和四种测量工具使用相同的人类输入完成验证挑战。各类挑战的实测状态说明了哪些可以通过，哪些不行。
• 工作凭证： record 和 video 可将一次运行制作为视频，每次工具调用都会成为运行轨迹中的一个步骤。

工具参考中列出了完整工具清单。Agent 可以执行哪些操作由应用决定，而不是由客户端决定。

桥接程序

bridge/scalebrowser-mcp.mjs 是一个无依赖的 stdio MCP 服务。如果 Scalebrowser 应用在同一台 Windows 机器上运行，它会使用应用保存在 %LOCALAPPDATA%\Scalebrowser 中的地址和令牌，将每条消息转发到应用自己的 MCP 端点。如果没有应用，它会返回工具列表和安装说明。MCP 目录在构建此仓库时看到的就是这种模式。

支持 HTTP 通信的客户端不需要它：使用上面的配置即可。对于只能通过 stdio 启动服务的客户端，可从 npm 运行它：

npx -y @scalebrowser/mcp

也可以从此仓库的克隆运行：

node bridge/scalebrowser-mcp.mjs

需要 Node 22 或更高版本。--data-dir 用于指定其他数据目录，SCALEBROWSER_TOKEN 用于覆盖令牌文件中的令牌。

作为 Claude 桌面扩展

每个版本都包含一个 MCP Bundle 格式的桥接程序，文件名为 scalebrowser-<version>.mcpb。在应用运行的 Windows 机器上下载该文件并用 Claude 桌面应用打开，或在其中选择Settings、Extensions、Install Extension。无需配置：它会自行查找应用和令牌。

该桥接程序也已作为 net.scalebrowser/mcp 列入 MCP Registry。

作为 Claude Code 插件

此仓库也是一个 Claude Code 插件。在应用运行的 Windows 机器上的 Claude Code 中：

/plugin marketplace add blackdiamond-labs/scalebrowser-mcp
/plugin install scalebrowser@scalebrowser

该插件会启动桥接程序，因此需要 Node 22 或更高版本，且无需在任何文件中保存令牌。它还会添加一个技能，指导 Agent 按照租用、读取、操作、释放的循环工作，在重复失败操作前先查看页面，并使用已保存的登录信息登录，而不是索要密码。

SDK 示例

两个 SDK 都使用同一项简单任务：在一个配置文件中打开 Hacker News，并打印排名前三的故事。在应用运行的 Windows 机器上运行，并将令牌放入 SCALEBROWSER_TOKEN。

cd examples/node
npm ci
node top-stories.mjs

cd examples/python
pip install --require-hashes -r requirements.txt
python top_stories.py

两者都使用已发布的 SDK：npm 上的 @scalebrowser/sdk 和 PyPI 上的 scalebrowser。SDK 文档介绍了完整功能。

隐私政策

此桥接程序不会收集、存储或向我们或任何其他人发送任何内容。

• 读取的内容： Scalebrowser 应用保存在你机器数据目录中的地址和 API 令牌；除非你传入 --data-dir，否则该目录为 %LOCALAPPDATA%\Scalebrowser。
• 消息发送到哪里： 仅发送到同一台机器上的 Scalebrowser 应用。它会拒绝任何不是本机环回地址的地址，因此令牌和 Agent 的消息绝不会通过此桥接程序离开计算机。
• 保留的内容： 无。它会在内存中与应用保持会话，并在客户端断开连接时结束会话。它不会写入文件，也不会写入日志，只有打印到标准错误的状态行除外。
• 第三方： 无。此桥接程序没有依赖项、遥测功能，也不会自行访问网络（连接到应用的环回连接除外）。

Scalebrowser 应用本身、账户和网站受 Scalebrowser 隐私政策约束。有关隐私的问题，请发送邮件至 [email protected]。

问题与支持

请发送邮件至 [email protected]。此仓库已关闭 Issues；CONTRIBUTING.md 说明了原因。

链接

• 网站
• 文档和快速入门
• 定价

许可证

此仓库中的所有内容均采用 MIT 许可证。Scalebrowser 应用及其浏览器引擎是单独授权的产品。