试验鱼 MCP

一个MCP服务器,在自己的计算机上给您的AI代理一个真正的Chrome浏览器. 你的经纪人自己的模特都读了 页面并选择每个步骤; 领航鱼带出该步骤,检查并告诉代理人什么变化.

对于使用克洛德代码, Codex CLI, Cursor, Claude D桌面, VS代码或其他代码的人来说 MCP 磁共振 客户端。 自由与麻省理工获得许可:没有账户,没有API密钥,没有飞行员鱼服务器. 它需要Node.js 22或更新的Chrome,Edge或Chrome.

claude mcp add pilotfish -- npx -y @gaiventures/pilotfish-mcp

其他客户端的设置如下. 要完成全部任务 在飞行员的云浏览器,签到 使用您保存的登录符, 请见下文“ 本地或管理” .

为什么是领航鱼

• 它点击它的意思. 工具从页面对参考文件进行操作(browser_click {ref: "e12"}) (中文(简体) ). 如果该元素 被覆盖,去或关闭屏幕, 点击被拒绝 而不是降落在错误的东西上 报告什么改变了.
• 它廉价地阅读页面. 代理人看到可见屏幕的紧凑轮廓. 先看完再说 只得到改变的行,和 browser_query 拔出它所需要的价值.
• 你负责. 签名,一次性代码和CAPTCHA在浏览器窗口中交给您. 付款, 命令、信件和删除等.
• 你的密码不在模型之外. 您配置的秘密类型为 {{name}} 占位符和蒙面符 在每一个结果.
• 它在当地运行. 新的浏览器在您的机器和您的互联网连接上, 当您的代理商关闭时关闭 断开 Cookie的横幅被拒绝,广告和追踪器在代理商看到页面前被屏蔽.

本地还是管理?

这个包是本地版本. 管理试验鱼 (单位:千美元)@gaiventures/pilotfish-mcp-managed是一个 付费服务:领航鱼在其云浏览器中运行整个任务,并将结果交给代理商.

当您在您的办公桌并想要您的代理驾驶时使用本地端 。 需要完成任务时使用管理 留在运行之间的地点, 或继续运行到机器人检查。 管理需要一个领航鱼账户 (单位:千美元)与 Google 签约页:1 软件包页面 每个客户的设置 工具和价格.

无站点名称的任务 . 您的代理先搜索网页( 使用自己的搜索工具) 来选择网站, 或回答 从搜索中找到足够。 它打开一个网站与 browser_navigate 当任务需要时: 你的约会 表格 账户 有了这个包裹, 搜索是你的代理, 不是飞行员的.

所需资源

• 22号节点或更新
• Google Chrome, 微软边缘或Chrome. 设定 PILOTFISH_CHROME 来选择一个.

设置

克劳德代码

claude mcp add pilotfish -- npx -y @gaiventures/pilotfish-mcp

在本地窗口( 不是 WSL) 上, 使用 claude mcp add pilotfish -- cmd /c npx -y @gaiventures/pilotfish-mcp。 。 。 . 设置在 -- 作为 -e NAME=value,例如 -e PILOTFISH_HEADLESS=1。 。 。 .

代码 CLI

单位 ~/.codex/config.toml数字 :

[mcp_servers.pilotfish]
command = "npx"
args = ["-y", "@gaiventures/pilotfish-mcp"]
# browser_resume waits up to 300 s for you; Codex stops a call after 60 s by default.
tool_timeout_sec = 330
# Optional:
# env = { PILOTFISH_HEADLESS = "1", PILOTFISH_ALLOWED_HOSTS = "example.com,*.example.com" }

光标、 Claude 桌面、 Windsurf等

在《诅咒》中 ~/.cursor/mcp.json (或 .cursor/mcp.json 在一个项目中,克劳德桌面 claude_desktop_config.json,或者您的客户的等同:

{
  "mcpServers": {
    "pilotfish": {
      "command": "npx",
      "args": ["-y", "@gaiventures/pilotfish-mcp"]
    }
  }
}

设置在一个 env 对象旁边 args。 。 。 . npx -y 运行最新版本; 保留其中的编号 名称后( e)@gaiventures/pilotfish-mcp@<version>) (中文(简体) ). npx -y @gaiventures/pilotfish-mcp --version 打印 您的版本已经.

浏览器在自己的窗口中打开,当一个页面需要一个人时,在其中签名或解决一个CAPTCHA. PILOTFISH_HEADLESS=1 隐藏它; 在没有显示的 Linux 机器上, 它已经隐藏了 .

超过 HTTP

每个客户端共享一个浏览器,在127.0.0.1上:

npx -y @gaiventures/pilotfish-mcp --http --port 8931
claude mcp add --transport http pilotfish http://127.0.0.1:8931/mcp

使用 URL 的客户端 "url": "http://127.0.0.1:8931/mcp"。服务器只回答发送到 当地主机。 设定 PILOTFISH_MCP_TOKEN 要求 Authorization: Bearer <token>它必须服务于任何 其他地址。 .

工具

如何表现

每个屏幕一次. 你的经纪人为它所读的每个信物付了钱 新的信物比它拥有的要贵得多 已经看过了 所以当特工在一页上行动时 它在最后8个结果中看到过 它只得到一条线 更改, 在其未更改的父行下分别标记 ~ ,其中删除的元素由参考文献列出。 校对器保持 在快照之间相同, 因此没有再次发送的行仍然有效 。 如果超过一半的屏幕被改变 整个屏幕,和 browser_snapshot 总是归还一切.

需要一个人的页面. 每次动作后,会检查页面 。 登录它没有资格,a 一次性代码或双因子快取、设备批准、登录链接、密码、三维安全或CAPTCHA NEEDS A PERSON 说明结果。 您在浏览器窗口处理它, 代理呼叫 browser_resume。 。 。 . pilotfish从未尝试通过这些页面本身:没有猜测的密码或代码,也没有CAPTCHA解析. 一个客户 支持引出 直接问你。 单靠自己清空的机器人检查首先要等出来,直到 12秒钟. BLOCKED: 表示网站拒绝了这个浏览器,并且 STOP: 标记一个不能自动化的网站.

证实. 看上去不可逆的行动(支付、发出命令、发送、删除)需要您同意。 一个客户端 诱导要求你;任何其他客户都会被拒绝行动,有原因.

设置

所有选择.

有秘密的例子:

"env": {
  "PILOTFISH_SECRETS": "{\"shop_password\": {\"value\": \"...\", \"allowedHosts\": [\"shop.example.com\"]}}"
}

隐私

领航鱼只连接到您代理打开的网站,加上公共广告封条列表(EasyList、EasyPrivacy和EasyPrivacy) uBlock Origin的过滤器, 每周下载一次, 并缓存到 ~/.pilotfish/adblock没有遥测,没有 飞行员服务器,没有模型供应商.

解决问题

• 找不到铬可执行文件 : 安装 Google Chrome, 或设置 PILOTFISH_CHROME 通往边缘Chrome的道路 或铬.
• 服务器不启动于 Windows : 开始 npx 结束 cmd /c (见上文Claude Code),并检查 node --version 22岁或更新.
• 在您报名时, 一个呼叫时间 : 将客户端的工具超时超过 300 秒( Codex : tool_timeout_sec自此以后 browser_resume 最多300 s给你.
• 一个网站继续屏蔽浏览器 : 这个软件包使用你自己的IP和一个平地Chrome,从不解决CAPTCHA. 清除浏览器窗口中的检查, 或者使用 管理试验鱼。 。 。 .

更多来自领航鱼

• 管理试验鱼:云中全任务,, 签了你的名.
• 试鱼软件:从网络运行任务,保存登录,观看直播,看到回放.

许可证

麻省理工学院