pilot — 在你真实的 Chrome 中运行 AI 智能体

安装一个 Chrome 扩展程序。你的 AI 智能体将在你正在使用的浏览器中获得一个标签页。

其他所有浏览器工具都会启动一个全新的匿名浏览器。你的智能体启动时处于未登录状态，会被 Cloudflare 拦截，且无法访问任何需要身份验证的内容。

Pilot 是一个 Chrome 扩展程序 + MCP 服务器。它将你的 AI 智能体连接到你真实的浏览器 —— 拥有相同的会话、相同的 Cookie 和相同的登录状态。你的智能体所见即你所见。

You: "Summarize my GitHub notifications"

→ New tab opens in YOUR Chrome
→ Already logged into GitHub
→ Agent reads, summarizes, done

无需无头浏览器。无需破解 Cookie。无需重新认证。无需担心机器人检测。

工作原理

AI Agent → MCP Server → WebSocket → Chrome Extension → Tab in your browser
         (stdio)       (localhost)

1. Pilot 作为 MCP 服务器运行 —— Claude Code、Cursor 或任何 MCP 客户端通过 stdio 连接

2. Chrome 扩展程序通过 localhost 上的 WebSocket 连接

3. 你的智能体在你真实的 Chrome 中获得自己的标签页 —— 你所有的会话都保持完整

4. 多个智能体获得独立的标签页 —— 通过颜色分组，以便你区分它们

快速开始

1. 添加 MCP 服务器

{
  "mcpServers": {
    "pilot": {
      "command": "npx",
      "args": ["-y", "pilot-mcp"]
    }
  }
}

2. 安装 Chrome 扩展程序

npx pilot-mcp --install-extension

打开 Chrome 的扩展程序页面。点击加载已解压的扩展程序 → 选择终端中显示的路径。

3. 使用它

“前往我的 GitHub 通知并进行总结”

你的 Chrome 中会打开一个标签页 —— 已经以你的身份登录。

精简快照

其他工具会将每个页面超过 50K 字符的内容转储到你的上下文窗口中。Pilot 保持内容精简：

Other tools:   navigate(58K) → navigate(58K) → answer        = 116K chars
Pilot:         navigate(2K)  → navigate(2K)  → snapshot(9K)  =  13K chars

snapshot_diff 仅显示操作之间发生变化的内容 —— 没有冗余的重复读取。

更少的上下文 = 更快的响应、更便宜的 API 调用、更少的幻觉。

Pilot 与 @playwright/mcp 的对比

3 种配置下的 61 个工具

大多数 LLM 在工具超过 30 个时性能会下降。仅加载你需要的工具：

{
  "mcpServers": {
    "pilot": {
      "command": "npx",
      "args": ["-y", "pilot-mcp"],
      "env": { "PILOT_PROFILE": "standard" }
    }
  }
}

默认：standard。完整工具参考 →

有头模式回退

当扩展程序未连接时，Pilot 会自动打开一个可见的 Chromium 窗口。

从你真实的浏览器导入 Cookie：pilot_import_cookies({ browser: "chrome", domains: [".github.com"] })

通过 macOS Keychain / Linux libsecret 支持 Chrome, Arc, Brave, Edge, Comet。对于验证码：pilot_handoff → 你进行干预 → pilot_resume。

要求：npx playwright install chromium

要求

• Node.js >= 18

• Chrome + Pilot 扩展程序 (推荐)

• macOS 或 Linux

• 仅回退模式：npx playwright install chromium

安全性

• 扩展程序仅在 localhost (127.0.0.1) 上通信

• 输出路径验证防止写入 PILOT_OUTPUT_DIR 之外的目录

• 所有文件操作均有路径遍历保护

• PILOT_PROFILE 控制暴露哪些工具 (core / standard / full)

致谢

核心架构 —— 基于引用的元素选择、快照差异对比、带注释的截图 —— 移植自 Garry Tan 的 gstack。基于 Playwright 和 MCP SDK 构建。

如果 Pilot 对你有帮助，请给仓库加星 —— 这有助于其他人发现它。