Yetibrowser Mcp

重要

此项目已归档。它最初旨在解决 Claude 和 Codex 等 AI Agent 缺少浏览器控制功能的问题，但如今这些 Agent 已内置相关功能，无需专门的基于 MCP 的解决方案。

YetiBrowser MCP

YetiBrowser MCP 是 Browser MCP 工作流的完全开源实现。它将基于 Node 的 MCP 服务与 Chrome/Firefox 扩展连接起来，让 Model Context Protocol 客户端（Codex/Claude Code、Cursor、Windsurf、MCP Inspector 或你自己的工具）能够自动化操作真实的浏览器标签页，同时确保所有数据都保留在你的设备上，并且可供审查。

为什么选择 YetiBrowser MCP？

• 透明且易于改造——没有二进制下载包。你可以检查、分叉并扩展每个组件。
• 本地优先——扩展只与本地主机上的 MCP 服务通信；浏览数据绝不会离开你的设备。
• 跨浏览器——Chrome 和 Firefox 版本使用相同的核心逻辑（Firefox 版本仍在等待更完善的 Manifest V3 支持，因此在 Mozilla 发布完整的 MV3 API 前，连接体验可能受限）。
• 面向开发者的工具——提供更丰富的控制台捕获、DOM 差异对比、页面状态转储和整页截图，专为调试和 QA 打造。
• 适合生产环境——提供用于打包、发布以及集成到 IDE 工作流的脚本和文档。

仓库结构

• packages/shared – 消息和工具架构的共享 TypeScript 定义。
• packages/server – 将 MCP 客户端连接到正在运行的浏览器标签页的 MCP 服务。
• extensions/shared – 共享扩展源码（后台程序/弹出窗口）和资源。
• extensions/chrome / extensions/firefox – 各浏览器专用的打包层。
• docs/ – 工作区命令、发布检查清单和功能说明。
• scripts/ – 辅助工具，例如用于生成发布压缩包的 package-extensions.sh。

可用的 MCP 工具

• browser_snapshot – 捕获当前页面中面向无障碍访问的快照
• browser_snapshot_diff – 比较最近两次快照，以突出显示 DOM/ARIA 变更
• browser_navigate – 在已连接的标签页中加载新 URL 并返回更新后的快照
• browser_go_back / browser_go_forward – 浏览历史记录，同时保持 MCP 同步
• browser_wait – 暂停自动化操作指定秒数
• browser_wait_for – 等待选择器出现（可选要求其可见）后再继续
• browser_press_key – 模拟在焦点元素上按下键盘按键
• browser_click – 点击由 CSS 选择器标识的元素
• browser_hover – 将指针悬停在目标元素上
• browser_drag – 将元素拖到放置目标上，适用于可排序/拖放式 UI
• browser_type – 在可编辑元素中输入文本（可选按 Enter 提交）
• browser_fill_form – 一次调用即可填写多个输入框/选择框/复选框/单选框
• browser_select_option – 在 <select> 元素中选择一个或多个选项
• browser_screenshot – 通过 DevTools 协议捕获视口或整页截图
• browser_get_console_logs – 返回近期控制台输出，包括带堆栈跟踪的错误
• browser_page_state – 转储已连接页面的表单、存储键和值以及 Cookie
• browser_connection_info – 报告桥接 WebSocket 端口、连接状态和扩展版本
• browser_evaluate – 在页面中运行自定义 JavaScript，并返回可序列化为 JSON 的结果
• browser_handle_dialog – 接受或关闭 alert/confirm/prompt 对话框，并可选提供提示文本

安装 MCP 浏览器扩展

Chrome 浏览器

• 在此处安装最新的 Chrome 浏览器扩展：https://chromewebstore.google.com/detail/hpedknkjljpopinabjjmljgckhlancni?utm_source=item-share-cb
• 除非你运行了多个 YetiBrowser MCP Server 实例，否则请保持连接模式为 Automatic

Firefox 浏览器（目前不可用）

• 由于 Firefox 稳定版中 Manifest v3 的功能有限，Firefox 扩展暂缓推出，直到该版本获得广泛的完整支持（Nightly 构建版除外）。

MCP 服务安装

Codex CLI

• 编辑你的 ~/.codex/config.toml 并添加 MCP 条目：

  [mcp_servers.yetibrowser-mcp]
  command = "npx"
  args = ["-y", "@yetidevworks/server"]
  

• 重启 codex CLI 命令；你应该能在 /mcp 工具下看到 yetibrowser-mcp。
• 如果要指定端口，请在 args 条目中使用以下格式：args = ["-y", "@yetidevworks/server", "--ws-port", "9010"]

Claude Code

• 确保扩展已安装并连接到一个标签页，然后使用 npx -y @yetidevworks/server 启动 MCP 服务（或运行本地构建的 CLI）。
• 将服务条目添加到 ~/Library/Application Support/Claude/claude_desktop_config.json（请参阅 docs/publishing.md 中的示例）。
• 重启 claude 以加载新的 MCP 服务；扩展连接后，你应该能在 /mcp 工具菜单中看到 yetibrowser-mcp。

其他支持 MCP 的客户端

• 任何 MCP 客户端都可以通过启动 CLI（npx -y @yetidevworks/server）进行连接，也可以选择指定端口，例如 npx -y @yetidevworks/server --ws-port 9010。
• 服务通过 stdio 提供标准 MCP 传输，因此只要有标签页连接，就可以使用客户端支持的任意配置机制运行上述命令。

MCP Inspector

• 用于在编码 Agent 之外进行测试和调试。
• 运行 npx @modelcontextprotocol/inspector npx -y @yetidevworks/server -- --ws-port 9010，即可结合 YetiBrowser MCP 浏览器扩展运行并检查 MCP 服务。

故障排除

• CLI 会依次尝试 9010-9020 端口，直到找到可用端口；端口递增时会记录 switched to。如果要固定使用某个端口，请传入 --ws-port <port>。
• 浏览器扩展弹出窗口的行为与此相同：保持“自动”以跟踪 CLI 的端口，或选择“手动”并输入 browser_connection_info / CLI 日志报告的端口以覆盖设置。
• 直接询问你的 AI 工具连接端口即可。例如：what is the yetibrowser mcp connction info?，然后将手动端口设为报告的端口。

文档与构建脚本

• 工作区命令位于 docs/workspace-commands.md。
• 发布步骤（npm + 扩展商店）见 docs/publishing.md。
• 截图行为记录在 docs/screenshot.md 中。
• 使用 ./scripts/package-extensions.sh 生成可分发的 Chrome/Firefox 压缩包（输出到 artifacts/）。
• 仓库级隐私政策见 PRIVACY.md。