Vibe MCP — Real Chrome, Remotely

Vibe MCP — 为 AI Agent 提供浏览器自动化

适用于 Vibe AI Browser 的 MCP 服务——通过任意 MCP 客户端操控你已登录的真实 Chrome，也支持在另一台机器上运行且无需开放入站端口的 Agent。

⚠️ 安全提示——请像对待密码一样保护你的中继 URL/UUID。 中继 URL 或扩展程序 UUID（wss://relay.api.vibebrowser.app/<uuid>）可实时控制你的浏览器会话（读取标签页、截取屏幕截图、读取页面内容）。请勿分享、粘贴到与不可信对象的聊天中，或提交到代码仓库。本说明文档中的 UUID 示例均为不可路由的占位符（YOUR-EXTENSION-UUID 或 00000000-0000-0000-0000-000000000000）——请在本地替换为你自己的密钥值，并避免将其纳入版本控制。

面向 AI Agent 的安装提示词（OpenClaw / Hermes）

将下面的代码块粘贴到你的 OpenClaw 或 Hermes Agent 中。将最后一行替换为你的远程值——在 Vibe 扩展程序的 Settings → AI Agent Control → Remote (internet) → Relay access 中显示的连接器 URL（https://relay.api.vibebrowser.app/mcp/<uuid>）（也仍可使用纯 UUID 或 wss:// 中继 URL）。这是你唯一需要修改的内容。

You are setting yourself up to control my real Chrome through Vibe Browser. Work through the steps in order, and after each step confirm it worked before moving on. Do not claim a step is done until you have proven it.

1. Install the "vibebrowser" skill for your runtime:
   - OpenClaw:  npx -y skills add VibeTechnologies/vibe-mcp -s vibebrowser -a openclaw -g -y --copy --dangerously-accept-openclaw-risks
                then run `openclaw skills list` and confirm a "vibebrowser" row shows "ready" as installer registration.
   - Hermes:    npx -y skills add VibeTechnologies/vibe-mcp -s vibebrowser -y
                optional installer registration check: `npx -y skills list` shows a "vibebrowser" row.

2. Remember my remote so I only give it to you once. Save it to a file `vibebrowser-cli.md` in your persistent agent workspace root (the directory that holds your `memory/` folder — not the shell's working dir, not $HOME unless they are the same) as a line `remote: <value>`; if your runtime can also write memory keys, additionally store it under `vibebrowser_remote`. On every later command — including the first message of a new conversation — load it back from that file and reuse it without asking me again.

3. Record a standing rule so you route correctly later: whenever I ask you to do anything in MY browser / MY Chrome / MY tabs / the page I'm on, use this vibebrowser skill (`npx -y @vibebrowser/cli@latest` with my saved remote) to drive my REAL browser — never your built-in, headless, or in-pod browser, never web-fetch instead, and never run `vibebrowser`. Save this rule wherever your standing instructions/memory live so it applies in future conversations.

4. Confirm you can control my Chrome, retrying on "Extension reconnecting" (wait 3s, up to 5x):
   npx -y @vibebrowser/cli@latest --remote "<my remote>" --json status --wait-for-extension --wait-timeout 20000
   npx -y @vibebrowser/cli@latest --remote "<my remote>" --json snapshot --format aria

Then report: (1) is extensionConnected true, (2) did the snapshot return my real page content?

My remote: <PASTE YOUR CONNECTOR URL, UUID, OR wss:// URL HERE>

为什么选择 Vibe MCP？

浏览器自动化 MCP 领域发展迅速。过去能让我们脱颖而出的多数特性，如今已是基本配置——因此，这里提供一份坦诚的对比表。竞品具备与我们相同的能力时，对应列会标注 Yes。

其中两项能力只有我们具备：

• 跨机器的出站控制。 Vibe 扩展会主动向外建立到中继服务的 WebSocket 连接（wss://relay.api.vibebrowser.app/<uuid>）。用户的机器上没有监听端口，也无需端口转发；Agent 可以运行在 Pod、定时任务或聊天机器人中。没有竞品记录扩展主动向远程 MCP 服务发起出站连接。
• 使用真实个人资料，且不受对话框困扰。 Chrome DevTools MCP 每次与 Chrome 建立 WebSocket 连接时都需要审批（#1794，仍开放；持久化方案已被以不会修复为由关闭）。维护者的变通方案是使用 --remote-debugging-port 和专用的 --user-data-dir，以此避开对话框，但代价是无法使用你已登录的个人资料。因此：要么跳过对话框，要么使用真实个人资料——无法两者兼得。

另外还有几点值得了解：

• 供应商锁定。 Claude for Chrome 已正式发布，通过 debugger 权限实现点击和输入，并支持计划任务——它是最接近我们的竞品。但它只能操作 Anthropic 自有界面（侧边栏、Claude Desktop 连接器、Cowork、Claude Code）。它没有公开 API 或 MCP 接口，因此 Codex、OpenCode、Hermes 和 OpenClaw 都无法使用。Vibe MCP 不绑定特定 Agent。
• 稳定性。 Chrome DevTools MCP 明确处于实验阶段，目前存在尚未解决的内存泄漏问题（#2431、#2291、#2456）和并发问题（#1763、#1921）。

多 Agent 架构

同时运行 Claude Desktop、Cursor、VS Code Copilot 和 OpenCode——它们通过中继服务共享对同一个浏览器的控制权。中继服务会复用请求，并将每个响应路由回发起请求的 Agent。

Claude Desktop       Cursor          VS Code         OpenCode
     |                  |                |               |
     v                  v                v               v
 [vibebrowser-mcp] [vibebrowser-mcp] [vibebrowser-mcp] [vibebrowser-mcp]
     |                  |                |               |
     +------------------+----------------+---------------+
                        |
                        v
                  [Relay Daemon]  <-- Auto-spawned, handles multiplexing
                        |
                        v
                 [Vibe Extension]
                        |
                        v
                   [Your Chrome]

功能

• 支持多 Agent - 可同时运行 Claude、Cursor、VS Code 等工具，操作同一个浏览器
• 使用你的浏览器 - 无需单独启动浏览器实例，使用你现有的 Chrome，其中保留了你的所有登录状态
• 支持远程连接 - 扩展会主动连接到中继服务，因此 Agent 可以在另一台机器上运行，无需开放入站端口
• 默认本地运行 - 在本地模式下，所有内容都保留在 127.0.0.1；只有远程中继模式会通过 relay.api.vibebrowser.app 路由流量
• 直接使用 Chrome DevTools 模式 - 默认优先使用扩展工具；使用 --devtools 可通过 DevTools Protocol 直接驱动正在运行的 Chrome（无需扩展）

快速开始

1. 安装 Vibe 扩展

在 Chrome、Brave 或任何 Chromium 浏览器中安装 Vibe AI Browser 扩展：

选项 A：Chrome 网上应用店（推荐）

1. 访问 Chrome 网上应用店
2. 点击“添加至 Chrome”
3. Vibe 图标将显示在工具栏中

选项 B：开发者版本

1. 下载最新版本 ZIP
2. 解压到一个固定文件夹
3. 前往 chrome://extensions，启用开发者模式
4. 点击“加载已解压的扩展程序”，并选择解压后的文件夹

详细说明请参阅安装指南。

2. 配置你的 AI 应用

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

{
  "vibe": {
    "command": "npx",
    "args": ["-y", "@vibebrowser/mcp"]
  }
}

{
  "github.copilot.chat.mcpServers": {
    "vibe": {
      "command": "npx",
      "args": ["-y", "@vibebrowser/mcp"]
    }
  }
}

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

{
  "mcp": {
    "servers": {
      "vibe": {
        "command": "npx",
        "args": ["-y", "@vibebrowser/mcp"]
      }
    }
  }
}

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

codex mcp add vibe -- npx -y @vibebrowser/mcp

[mcp_servers.vibe]
command = "npx"
args = ["-y", "@vibebrowser/mcp"]

MCP 命令形式

使用最简洁的直接包调用方式来启动 MCP 服务：

npx -y @vibebrowser/mcp@latest --help
npx -y @vibebrowser/mcp@latest start --transport http
npx -y @vibebrowser/mcp@latest openclaw --remote "$VIBE_REMOTE_URL"

需要指定二进制文件时，仍可使用向后兼容的别名：

npx -y -p @vibebrowser/mcp@latest vibebrowser-mcp --help
npx -y -p @vibebrowser/mcp@latest vibe-mcp --help

远程连接器（托管助手——无需安装）

以上内容都假设客户端可以启动本地进程。托管助手无法做到这一点：网页版、Cowork 中和移动端的 Claude，以及网页版 ChatGPT，都运行在供应商的云端，无法访问你的机器。它们只接受远程 MCP 服务 URL，除此之外不接受任何内容——没有命令、参数或自定义请求标头。

对于这些客户端，完全跳过 @vibebrowser/mcp。只需扩展程序即可：

https://relay.api.vibebrowser.app/mcp/<your-extension-uuid>

在扩展程序中找到 <your-extension-uuid>：Vibe 图标 → Settings → AI Agent Control → Remote (internet) → Relay access。此面板会显示这个确切的连接器 URL；现在，同一个字符串也是 CLI/服务 --remote 标志的首选值——将其粘贴到两处即可，无需转换：

VIBE_REMOTE_URL="https://relay.api.vibebrowser.app/mcp/00000000-0000-0000-0000-000000000000"
npx -y @vibebrowser/mcp@latest start --remote "$VIBE_REMOTE_URL"

裸扩展程序 UUID 或 wss://relay.api.vibebrowser.app/<uuid> 中继 URL 仍可作为高级/兼容形式使用——请参阅下文“Cloud OpenClaw -> Local Browser”中的 --remote 接受值表。

这是一个普通的 Streamable HTTP MCP 端点。此路径没有 OAuth 同意流程、动态客户端注册或作用域设置——URL（或下文所述标头）中的 UUID 就是完整凭据。如果某个客户端坚持要求先进行 OAuth 登录才允许添加服务，则此处不支持该客户端；请改用本地 stdio 路径。

粘贴位置：

Claude 和 ChatGPT 产品中的自定义连接器是付费计划功能。

Codex Desktop、Codex CLI 和 Codex IDE 扩展程序可以启动本地进程，并且共用 ~/.codex/config.toml。优先使用上文的本地 stdio 条目——这样流量会保留在 127.0.0.1 上，UUID 也不会出现在 URL 中。只有当你要控制的浏览器与 Codex 位于不同机器时，才使用 codex mcp add vibe --url …。ChatGPT 桌面应用由 Codex 提供支持，并读取同一份配置，因此它也支持本地 stdio；只有 ChatGPT 网页版需要托管 URL。

迁移离开已弃用的 OAuth 风格连接器指南

这些文档的早期草稿（以及保存在 worklog/ 下的 2026 年 8 月目录提交调研）描述了一种已弃用的 OAuth 2.1 + DCR 同意流程，入口是裸路径 /mcp。该路径已弃用，不再面向用户提供支持。如果你之前添加了 Vibe 作为连接器，并被引导至已弃用的同意页面，请移除该连接器，然后使用上方的直接 URL https://relay.api.vibebrowser.app/mcp/<uuid> 重新添加。无需授权、无需注册，也无需选择权限范围。

中继服务也接受通过 X-Remote-Session 或 Authorization: Bearer 请求头，在裸路径 POST /mcp 中传入 UUID。任何能够发送请求头的程序（Codex CLI、脚本）都可以使用请求头形式——这样凭据就不会出现在 URL、日志和浏览器历史记录中。路径形式专为无法发送请求头的 UI 而设。

明确说明：使用此路径需要付出两方面代价：

1. URL 就是凭据。 任何拥有该 UUID 的人都能操控你已登录的浏览器——读取你的邮件，并以你的身份在你已登录的任何网站上执行操作。请像对待密码一样保护它：切勿提交它，切勿将它粘贴到共享聊天、问题、README 或截图中。如果它泄露了，请在扩展程序中撤销会话并生成新的 UUID。（这并非假设：某台开发机器的 UUID 曾经出现在这些文档中。）
2. 页面内容会离开你的设备。 使用本地 STDIO 路径时，工具调用和页面内容绝不会离开 127.0.0.1。使用远程连接器路径时，它们会经过 relay.api.vibebrowser.app，因为助手位于供应商的云端，没有其他途径可以连接到你的浏览器。如果你需要仅在设备上运行，请改用搭配本地服务的桌面客户端。

3. 连接扩展程序

1. 打开已安装 Vibe 扩展程序的 Chrome
2. 点击工具栏中的 Vibe 扩展程序图标
3. 前往 Settings 并启用 “MCP External Control”
4. 状态应显示 “Connected”

如果扩展程序未连接，vibebrowser-mcp 可以选择在安装了 chrome-devtools-mcp 包时，回退使用 chrome-devtools-mcp（以 --autoConnect 模式启动）。 此回退在共享的本地中继守护进程中运行一次（可安全用于多个 Agent），因此 vibebrowser-mcp 和 vibebrowser-cli 使用的是同一个后端实例。 扩展程序连接后，以扩展程序工具为准。

--devtools 模式（通过 CDP 操控实际运行的 Chrome）

向任一 CLI 传入 --devtools，即可完全绕过中继／扩展程序路由，直接通过 Chrome DevTools Protocol 操控实际运行的 Chrome。 此后端移植自 chrome-use 技能，会读取 Chrome 的 DevToolsActivePort 文件，并自动连接到你的实时配置文件——无需扩展程序、无需外部 MCP 服务，也无需任何额外依赖。需要 Chrome 144+；每个配置文件只会触发一次权限对话框。

--devtools 提供一组精简的工具：navigate、snapshot（包含 @eN 引用的无障碍树）、click、fill、type、press_key、hover、scroll、screenshot、eval、get_text、get_url、get_title，以及标签页管理工具（list_tabs、new_tab、select_tab、close_tab）。使用 snapshot 获取 @eN 元素引用，然后将其作为选择器传给 click／fill／type。

使用 VIBE_CHROME_USER_DATA_DIR 和 VIBE_CHROME_CHANNEL（stable | canary | beta | dev）覆盖 Chrome 配置文件／渠道。

--devtools v1 尚未涵盖以下功能（后续可随着接入更多 CDP 域添加）：网络请求检查、控制台日志、性能跟踪、Lighthouse、内存快照、设备模拟、对话框处理、文件上传和拖放。

可用工具

工作原理

默认本地模式（无标志）：

Claude / Cursor / VS Code (stdio)
            │
            ▼
   [vibebrowser-mcp]
            │  ws://127.0.0.1:19888
            ▼
     Local Relay (auto-spawned)
            │  ws://127.0.0.1:19889
            ▼
     Vibe Extension (Chrome)

1. AI 应用通过 MCP 使用 stdio 连接
2. vibebrowser-mcp 连接到端口 19888 上的本地中继
3. 中继将命令转发到端口 19889 上的扩展
4. 结果返回给 Agent

两段链路，两种协议

不要将两者混为一谈——到 MCP 服务的传输方式可配置，到扩展的传输方式则不可配置。

MCP client ──stdio──┐
                    ├──> [vibebrowser-mcp] ──ws──> [relay] ──ws──> [extension]
MCP client ──http───┘

可流式传输的 HTTP 让远程或托管的 Agent（无法启动 stdio 子进程的 Agent）能够通过 URL 与服务通信：

npx -y @vibebrowser/mcp@latest start --transport http
# serves POST/GET http://127.0.0.1:8788/mcp

默认值：--host 127.0.0.1、--http-port 8788、--http-path /mcp。如果通过代理访问或将服务绑定到 localhost 以外的地址，请添加 --allow-host <host>（可重复指定）。

多 Agent 模式

连接多个 Agent 时，Vibe MCP 会自动启动中继守护进程：

• 第一个 Agent 启动中继（监听端口 19888 和 19889）
• 其他 Agent 作为客户端连接到中继
• 中继将所有 Agent 的请求复用到单个扩展连接
• 每个 Agent 只会收到自己的响应

云端 OpenClaw → 本地浏览器

⚠️ 安全性： 下方的 --remote 值是可用凭据——中继 URL/UUID/连接器 URL 可授予对目标浏览器会话的完全控制权。它是唯一的持有者凭据（没有第二重身份验证令牌）。请像对待密码一样保密：切勿泄露、提交或粘贴到日志中；如果发生泄露，请在 Vibe 扩展的设置中重新生成。

--remote 支持的值

--remote（以及 MCP set_remote 工具）接受三种形式，都会规范化为相同的中继连接：

可自托管或本地中继也以相同方式推导：https://your-host/vibe/mcp/<uuid> → 中继 wss://your-host/vibe；环回连接器，例如 http://127.0.0.1:19889/mcp/<uuid> → ws://127.0.0.1:19889（仅适用于可自托管 / 本地中继 — 非环回主机必须使用 https:///wss://）。

以下情况会被拒绝：无效 UUID；包含内嵌凭据、查询字符串或片段的 URL；非环回主机上的明文 http:///ws://；以及任何未以精确的 /mcp/<uuid> 后缀结尾的 HTTP(S) URL。

如果你的 Agent 在云端运行，但你希望它控制用户真实的本地浏览器，请以 HTTP 模式运行 vibebrowser-mcp，并将其连接到远程中继模式下的 Vibe 扩展程序。将连接器 URL（首选）、扩展程序 UUID 或完整的 WebSocket 中继 URL 传递给 --remote。

VIBE_REMOTE_URL="https://relay.api.vibebrowser.app/mcp/00000000-0000-0000-0000-000000000000"
npx -y @vibebrowser/mcp@latest start --transport http --remote "$VIBE_REMOTE_URL"

默认情况下，这会在 http://127.0.0.1:8788/mcp 暴露一个本地 MCP 端点。

当 OpenClaw 在另一台机器上运行时（例如托管在云端），请提供一个可访问的 URL：

VIBE_REMOTE_URL="https://relay.api.vibebrowser.app/mcp/00000000-0000-0000-0000-000000000000"
PUBLIC_MCP_URL="https://browser-bridge.example.com/mcp"
npx -y @vibebrowser/mcp@latest openclaw --remote "$VIBE_REMOTE_URL" --public-url "$PUBLIC_MCP_URL"

你可以使用以下命令打印适用于 OpenClaw 的确切设置：

VIBE_REMOTE_URL="https://relay.api.vibebrowser.app/mcp/00000000-0000-0000-0000-000000000000"
npx -y @vibebrowser/mcp@latest openclaw --remote "$VIBE_REMOTE_URL"

使用连接器 URL（首选）搭配默认公共中继、裸 UUID（默认公共中继），或在需要显式中继端点时使用 wss:// URL。无论使用哪种形式，它都是唯一的凭据 — 切勿分享、记录或粘贴到不受信任的聊天中。

直接检查浏览器 CLI 时，始终使用 npx -y @vibebrowser/cli@latest：

VIBE_REMOTE_URL="https://relay.api.vibebrowser.app/mcp/00000000-0000-0000-0000-000000000000"
npx -y @vibebrowser/cli@latest --remote "$VIBE_REMOTE_URL" --json status

连接器 URL 使用默认公共中继。--remote <uuid> 同样使用默认公共中继。--remote <full-ws-url> 则指向显式中继端点。无需也不接受第二因素密钥 — 传入的任何一种形式都是授权会话的唯一凭据。

完整操作指南请参阅 docs/openclaw-local-browser.md。

兼容 OpenClaw 的浏览器 CLI

npx -y @vibebrowser/cli@latest 为真实本地浏览器路径提供与 OpenClaw 浏览器 CLI 相同的结构：

npx -y @vibebrowser/cli@latest sessions
VIBE_REMOTE_URL="https://relay.api.vibebrowser.app/mcp/00000000-0000-0000-0000-000000000000"
npx -y @vibebrowser/cli@latest --remote "$VIBE_REMOTE_URL" status
npx -y @vibebrowser/cli@latest --remote "$VIBE_REMOTE_URL" tabs
npx -y @vibebrowser/cli@latest --remote "$VIBE_REMOTE_URL" open https://example.com
npx -y @vibebrowser/cli@latest --remote "$VIBE_REMOTE_URL" snapshot
npx -y @vibebrowser/cli@latest --remote "$VIBE_REMOTE_URL" click 12
npx -y @vibebrowser/cli@latest --remote "$VIBE_REMOTE_URL" type 23 "hello" --submit
npx -y @vibebrowser/cli@latest --devtools status

使用 MCP 包处理 MCP 服务工作流，使用 CLI 包直接控制浏览器：

• vibebrowser-mcp 用于 MCP 服务、HTTP 桥接和辅助命令
• npx -y @vibebrowser/cli@latest 用于对真实的 Vibe 连接会话进行受 OpenClaw 启发的浏览器控制

@vibebrowser/cli 为兼容性接受 OpenClaw 风格的 --browser-profile 标志，并支持 --json 输出机器可读内容。与 OpenClaw 管理的 openclaw 浏览器配置不同，此 CLI 始终指向真实的 Vibe 连接浏览器会话。

本地会话选择：

• npx -y @vibebrowser/cli@latest sessions 会列出已连接的本地浏览器会话。
• npx -y @vibebrowser/cli@latest --session <id> ... 会指定一个本地会话作为目标。
• 在本地模式下，如果省略 --session，CLI 会使用第一个已连接的会话。
• 在远程模式下，传入连接器 URL（首选）、不带参数的 --remote <uuid> 以使用默认公共中继，或传入 --remote <full-ws-url> 以使用显式指定的中继端点。

快照行为仅通过工具实现（没有旧版快照 RPC 快捷方式）：

• snapshot（默认 --format markdown；旧版别名为 --format ai）通过 take_md_snapshot 工具解析——使用内容脚本的页内 Markdown 提取器。速度快且易于阅读，但对于内容脚本无法访问或尚未计算布局的后台标签页或复杂的 SPA（Notion、Gmail），可能会返回空内容。如果后端只提供 take_snapshot，CLI 会发送 format: "markdown"（调用前会将 ai 映射为 markdown）。
• snapshot --format aria 通过 take_a11y_snapshot 工具解析——直接使用 Chrome DevTools Protocol 的 Accessibility.getFullAXTree。对所有标签页（包括后台标签页和 SPA）都可靠。 如果默认格式返回空内容或仅返回页面标题，请使用此格式作为回退方案。

这样可使 CLI 行为与扩展支持的工具保持一致，并确保使用 --page-id/--pageId 时页面定位始终正常。

对于导航类操作，当页面状态发生变化时，响应现在会包含页面内容：

• CLI 的 open / navigate 会在 JSON 输出中包含 pageContent。
• MCP 工具调用中的导航类工具会返回包含当前页面状态的文本内容（必要时会回退到快照）。

面向 AI Agent 的安装提示词（OpenClaw / Hermes）

请使用本 README 顶部唯一的标准复制粘贴提示词： 面向 AI Agent 的安装提示词（OpenClaw / Hermes）。 它会安装 vibebrowser 技能、保存远程地址，让你只需提供一次，并验证 对真实 Chrome 的控制能力。

如需更深入的技能定义（何时应优先于受管理的无头浏览器、远程地址回忆规则、选择器/快照指南），请将 openclaw/vibebrowser/SKILL.md 安装到 Agent 的技能目录中。

OpenClaw 集成

有两种方式将 Vibe 与 OpenClaw 配合使用：

选项 A：云端 OpenClaw 控制本地浏览器

如果 OpenClaw 在云端运行，但你希望它控制本地浏览器：

1. 安装 Vibe 扩展并启用 Remote 模式（参见 docs/openclaw-local-browser.md）
2. 启动本地 HTTP 桥接：vibebrowser-mcp openclaw --remote "$VIBE_REMOTE_URL" [--public-url "$PUBLIC_MCP_URL"]
3. 在 OpenClaw 中注册 MCP URL

选项 B：供本地 Agent 使用的 OpenClaw 技能

对于需要访问真实浏览器上下文（已登录会话、现有标签页）的 OpenClaw Agent：

1. 将此软件包中的 Vibe 技能复制到 OpenClaw 技能文件夹
2. 使用连接器 URL（首选）、扩展 UUID，或通过 --remote 使用完整的 WebSocket 中继 URL
3. 在 Agent 提示词中使用 npx -y @vibebrowser/cli@latest 命令

该技能位于 openclaw/vibebrowser/SKILL.md，并提供：

• 完全兼容 OpenClaw 的 CLI 命令（status、tabs、snapshot、click、type 等）
• 适用于 DevTools 支持流程的回退安全命令（resize、upload、dialog）
• 便于机器解析的 --json 输出
• 基于环境变量的配置

完整操作指南请参见 docs/openclaw-local-browser.md。

本地大模型：serve 命令

用一条命令运行本地大模型，无需云端 API 密钥。自动安装 Ollama、下载模型并启动兼容 OpenAI 的 API 服务。

npx -y @vibebrowser/mcp@latest serve qwen3.5

就是这么简单。支持 macOS、Linux 和 Windows。

功能说明

1. 检测 Ollama → 若未安装则安装（通过 brew、curl 或 winget）
2. 启动服务 → 在后台启动 ollama serve
3. 下载模型 → 在终端中显示下载进度
4. 输出连接信息 → 可立即与 VibeBrowser 或任何兼容 OpenAI 的客户端配合使用

推荐模型

npx -y @vibebrowser/mcp@latest serve qwen3.5      # Best overall for agentic tasks
npx -y @vibebrowser/mcp@latest serve llama4        # Strong general reasoning
npx -y @vibebrowser/mcp@latest serve deepseek-r1   # Reasoning chains
npx -y @vibebrowser/mcp@latest serve mistral       # Lightweight & fast (7B)

选项

npx -y @vibebrowser/mcp@latest serve <model> [options]

Options:
  -p, --port <number>  Ollama API port (default: 11434)
  -y, --yes            Skip install confirmation prompts
  -d, --debug          Enable debug logging

与 VibeBrowser 扩展配合使用

serve 完成后，配置扩展：

• 模型提供商 → ollama
• 模型名称 → 你运行的模型（例如，qwen3.5）

扩展会自动连接到 http://localhost:11434/v1。

CLI 选项

npx -y @vibebrowser/mcp@latest --help
npx -y @vibebrowser/cli@latest --help

# MCP server (default)
npx -y @vibebrowser/mcp@latest [start] [options]
  -p, --port <number>  WebSocket port for local relay (agent) connection (default: 19888)
  -d, --debug          Enable debug logging
  --transport <mode>   MCP transport to expose: stdio or http (default: stdio)
  --host <host>        Host to bind the HTTP server to (default: 127.0.0.1)
  --http-port <number> Port for streamable HTTP MCP transport (default: 8788)
  --http-path <path>   Path for streamable HTTP MCP transport (default: /mcp)
  --allow-host <host>  Allowed host header for HTTP transport (repeatable)
  -r, --remote <uuid-or-url>  Connect to a remote extension via relay. Accepts the connector URL from extension Settings (https://relay.api.vibebrowser.app/mcp/<uuid>), a bare extension UUID, or a ws(s) relay URL. This value is the sole bearer credential — treat it like a password; regenerate it in extension Settings if exposed.
  --devtools           Drive your real running Chrome directly over the DevTools Protocol (bypasses the extension relay)

# MCP server tool
set_remote { "url": "https://relay.api.vibebrowser.app/mcp/<extension-uuid>" }

set_remote MCP 服务工具可热重连正在运行的 MCP 服务，以连接到其他远程中继。它是 MCP 工具，而非浏览器 CLI 子命令。它接受与 --remote 相同的三种形式（首选连接器 URL、纯 UUID 或 wss:// URL）。该值是唯一凭据——切勿将其放入与不可信方共享的日志中；如果该值已泄露，请在扩展设置中重新生成。

# OpenClaw helper
VIBE_REMOTE_URL="https://relay.api.vibebrowser.app/mcp/00000000-0000-0000-0000-000000000000"
PUBLIC_MCP_URL="https://browser-bridge.example.com/mcp"
npx -y @vibebrowser/mcp@latest openclaw --remote "$VIBE_REMOTE_URL" --public-url "$PUBLIC_MCP_URL"

# OpenClaw-compatible browser CLI
npx -y @vibebrowser/cli@latest --remote "$VIBE_REMOTE_URL" status
npx -y @vibebrowser/cli@latest --remote "$VIBE_REMOTE_URL" status --wait-for-extension --wait-timeout 10000
npx -y @vibebrowser/cli@latest --remote "$VIBE_REMOTE_URL" tabs
npx -y @vibebrowser/cli@latest --remote "$VIBE_REMOTE_URL" snapshot --json
npx -y @vibebrowser/cli@latest --remote "$VIBE_REMOTE_URL" click 12
npx -y @vibebrowser/cli@latest --remote "$VIBE_REMOTE_URL" type 23 "hello" --submit
npx -y @vibebrowser/cli@latest --devtools tabs

# Local LLM server
MODEL="qwen3.5"
npx -y @vibebrowser/mcp@latest serve "$MODEL"
  -p, --port <number>  Ollama API port (default: 11434)
  -y, --yes            Skip confirmation prompts
  -d, --debug          Enable debug logging

故障排除

“无法连接到 Vibe 扩展”

1. 确保 Chrome 中已安装 Vibe 扩展
2. 点击扩展图标，并在设置中启用“MCP 外部控制”
3. 检查是否有防火墙阻止本地主机连接

“OpenClaw 无法连接到我的本地浏览器桥接”

1. 以 HTTP 模式而非 stdio 模式启动 vibebrowser-mcp
2. 确保桥接进程仍在用户的计算机上运行
3. 确认扩展处于 Remote 模式且已连接
4. 确认 OpenClaw 中的 MCP URL 与桥接 URL 匹配。如果 OpenClaw 托管在云端，请勿使用 127.0.0.1；使用 openclaw --public-url 并指定可访问的主机。

调试模式

启用调试日志以诊断问题：

{
  "mcpServers": {
    "vibe": {
      "command": "npx",
      "args": ["-y", "@vibebrowser/mcp", "--debug"]
    }
  }
}

开发

git clone https://github.com/VibeTechnologies/vibe-mcp.git
cd vibe-mcp
npm install
npm run build
node dist/cli.js --debug

关键词

浏览器自动化，MCP 服务，模型上下文协议，AI 浏览器控制，Claude 桌面浏览器，Cursor 浏览器自动化，网页自动化，Chrome 自动化，AI Agent 浏览器，多 Agent 浏览器控制，Playwright 替代方案，Puppeteer 替代方案，浏览器 MCP，AI 网页抓取，AI 网页 Agent

许可证

Apache-2.0

Links

• Vibe AI Browser - Main product
• Documentation - Full docs
• Chrome Extension - Install extension
• GitHub Issues - Report bugs
• npm Package - npm registry