byob

Bring Your Own Browser (自带浏览器) — 让你的 AI 助手使用你已经打开的 Chrome。

English · 中文

我可以用它做什么？

你可以让 Claude（或 Cursor / Cline）在网页上执行操作。byob 会在你真实的 Chrome 中实现这些操作——也就是你已经登录了 Twitter、GitHub、Gmail、工作工具等所有内容的那个浏览器。

人们经常提出的需求：

“阅读我的 Twitter 时间线并告诉我前 5 条推文”

byob 会打开一个标签页，滚动浏览，并将文本返回给你。因为它就是你真实的浏览器，所以你的推文会显示出来——没有虚假账号，无需复制粘贴 Cookie，也没有验证码。

“谷歌搜索 'mcp protocol spec'，点击第一个结果，并阅读该页面”

byob 会跳转到 google.com，输入你的搜索内容，按下回车，等待结果，点击第一个链接，然后阅读它。所有操作都在一个提示词中完成。

“给我我的 GitHub 会话 Cookie，这样我就可以在脚本中使用 curl”

byob 会把 Cookie 交给你。现在 curl https://github.com/... 的运行效果就像你已经登录了一样。

“给 example.com 截个图”

byob 会将 PNG 保存到磁盘并告诉 Claude 它在哪里。（不会将 base64 转储到 Claude 的上下文中——那会消耗掉你的 Token。）

“打开我的 Gmail 标签页并告诉我还有多少未读邮件”

云端无头浏览器无法查看你的 Gmail，因为它们没有登录。而 byob 可以——因为它就是你的浏览器。

Related MCP server: agent-browser-mcp

为什么不直接使用 WebFetch 或 Puppeteer？

5 分钟安装

git clone https://github.com/<you>/byob ~/code/byob
cd ~/code/byob && bun install

# one command does everything: makes a key, builds the extension,
# tells Chrome about it
( cd packages/bridge && bun run dev:cli install --dev )

# load the extension in Chrome:
#   chrome://extensions  →  Developer mode  →  Load unpacked
#   pick: packages/extension/.output/chrome-mv3
# then fully quit Chrome (⌘Q) and open it again

# check it works
( cd packages/bridge && bun run dev:cli doctor )
# four green ✓ means you're good

# tell Claude Code about byob
claude mcp add byob -s user -- /Users/$USER/code/byob/packages/mcp-server/node_modules/.bin/tsx /Users/$USER/code/byob/packages/mcp-server/bin/byob-mcp.ts

打开一个新的 Claude Code 会话并说 “use byob to ...”。

byob 可以做的 10 件事

完整的输入/输出结构：shared/src/schemas.ts。

它实际上是如何工作的

Claude Code  ─→  byob-mcp  ─→  byob-bridge  ─→  Chrome extension  ─→  your Chrome tab

四个跳转，全部在你的笔记本电脑上完成。没有任何东西离开你的机器。关闭 Chrome，一切都会退出——没有后台进程残留。

关于安全性的须知

• 🔒 browser_eval（运行 JS）默认关闭 — 即使 Claude 也看不到它的存在。通过在注册 MCP 时设置 BYOB_ALLOW_EVAL=1 来开启它。开启后，每次调用都会被记录并弹出 Chrome 通知。

• 🚫 某些网站默认被阻止 — chrome://、file://、你的 Google/Microsoft/Apple 登录页面。因此 Claude 不会意外读取你的密码管理器或 /etc/passwd。

• 🔑 你拥有自己的扩展密钥 — 安装时，byob 会为你生成一个专属密钥。两个运行 byob 的人会得到两个不同的扩展 ID，互不冲突。

• 📁 文件是私有的 — 套接字权限为 0600，文件夹权限为 0700。你电脑上的其他用户无法读取它们。

• 📡 byob 从不向外发送数据 — 没有分析，没有自动更新 ping，没有崩溃报告。零出站流量。

• ⚠️ Chrome 会在页面顶部显示“byob 正在调试此标签页”。无法隐藏它 — 这是 Chrome 的安全机制，不是 byob 的 bug。每个使用 Chrome 调试器的工具都有相同的横幅。

日常命令

byob install     # set everything up (or fix it after Chrome breaks)
byob doctor      # check what's working and what's not
byob bridges     # show me the running bridges
byob logs [-f]   # tail the log
byob uninstall   # nuke the launcher and manifests

想了解更多？

• 设计说明 — byob 的底层工作原理及原因

• 更新日志 — 已完成和即将推出的功能

• 贡献指南 — 如何提交 PR

• 测试清单 — 每次发布前需要尝试的事项

仍然卡住？运行 byob doctor — 它会告诉你具体哪一步出了问题。

MIT 许可。byob 对你的浏览器拥有很高的访问权限——请仅在你拥有的机器和账户上运行它。