Browse Bridge

Cursor 的 Browse Bridge

Cursor 插件，可将 Browse Bridge 远程 MCP 接入 Cursor，让 Agent 能够观察和控制你已在 Chrome 扩展程序中明确启用的浏览器标签页。

• MCP： https://mcp.browsebridge.com/mcp
• 网站： https://browsebridge.com
• Chrome 扩展程序： 可在 Chrome 网上应用店中找到
• 许可证： MIT

前提条件

1. 在 https://browsebridge.com/sign-up 创建账户（套餐：https://browsebridge.com/plans）。
2. 从 Chrome 网上应用店安装 Browse Bridge Chrome 扩展程序，并使用同一账户登录。
3. 登录并打开 Connections 创建 API 密钥（以 bbk_ 开头）。请妥善保密。
4. 支持插件/MCP 的 Cursor。

安装（Marketplace / 本地）

官方 Marketplace（上架后）

从 Cursor Marketplace 安装 browse-bridge，并在提示时粘贴你的 API 密钥（BROWSEBRIDGE_API_KEY）。

本地测试（Marketplace 上架前 / 未上架时）

# Copy (do not symlink outside this folder)
cp -R /path/to/browsebridge-cursor-plugin ~/.cursor/plugins/local/browse-bridge

重新加载窗口，打开 Customize，配置 BROWSEBRIDGE_API_KEY，并确认 MCP 工具已显示（browser_observe、browser_click 等）。

手动配置 mcp.json 片段

{
  "mcpServers": {
    "browse-bridge": {
      "url": "https://mcp.browsebridge.com/mcp",
      "headers": {
        "Authorization": "Bearer ${BROWSEBRIDGE_API_KEY}"
      }
    }
  }
}

插件变量仅会在插件内部填入，因此手动配置时请使用真实密钥或 ${env:BROWSEBRIDGE_API_KEY}。

使用方法

1. 打开一个普通网站标签页（不是 chrome://）。
2. 点击 Browse Bridge 工具栏图标，然后在想要共享的标签页上点击 Enable。接受确认提示和任何 Chrome 权限请求。你可以随时点击 Take control（或按 Ctrl+Shift+Period）取回标签页控制权。
3. 在 Cursor 中使用 MCP 工具，例如 browser_list_sessions、browser_observe、browser_click、browser_screenshot。
4. 遇到验证挑战 / 敏感网站时，Agent 可能会暂停，等待人工接管或批准。

工具（19 个）

工具	功能
browser_list_sessions	列出已启用的共享标签页。
browser_get_status	查看控制模式、URL、deviceOnline、待处理的批准请求、剩余月度配额（actionsRemaining、screenshotsRemaining、quotaExceeded、quotaResetAt）。月度配额用尽时，工具会返回 QUOTA_EXCEEDED。
browser_observe	语义页面树 + observationId / elementId。
browser_screenshot	将可见标签页的 JPEG 作为 MCP 图像内容返回。
browser_click	点击已观察到的元素。可选的 button："left"（默认）、"right" 或 "middle"。
browser_type	设置控件的值（不适用于密码）。
browser_select	选择列出的 <option>。
browser_press_key	在当前聚焦的元素（或指定元素）中按键。
browser_hover	在已观察到的元素上触发 mouseover / mouseenter。
browser_scroll	滚动页面，或将元素滚动到视野内。
browser_navigate	前往允许的 http(s) URL。
browser_back	返回上一页。
browser_forward	前往下一页。
browser_reload	重新加载标签页。
browser_wait	暂停 0–30000 毫秒。
browser_release_control	将标签页控制权交还给用户（controlMode: "human"）。
browser_handle_dialog	接受或关闭待处理的 JavaScript alert / confirm / prompt（action：accept|dismiss；接受 prompt 时可选填写 promptText）。
browser_cancel_approval	撤回待处理的 Agent 批准请求（approvalId）。
get_profile	只读获取已登录账户的 Browse Bridge 用户 ID（不包含电子邮件、令牌、Cookie 或页面内容）。

JavaScript 对话框

Agent 获得控制权后，页面的 alert / confirm / prompt 会一直处于等待中，直到调用 browser_handle_dialog（或约 30 秒后超时并关闭）。对话框打开时，其他点击、输入和导航调用会返回**DIALOG_PENDING**。原生 HTTP 基本或摘要身份验证提示不属于 JavaScript 对话框（HTTP_AUTH_REQUIRED）。由用户完成或取消这些提示。Browse Bridge 绝不会输入这些凭据。

审批

涉及敏感网站的点击、输入、导航以及跨源导航（和跨源链接点击）会返回**APPROVAL_REQUIRED**。用户可在 Chrome 侧边栏中批准或拒绝。Agent 可以撤回自己的请求，调用 browser_cancel_approval 即可（APPROVAL_CANCELLED——这不代表用户拒绝）。审批待处理期间，observe/screenshot/wait/get_status/list_sessions/release_control 仍可运行。

配置

变量	必填	说明
BROWSEBRIDGE_API_KEY	是	来自 Browse Bridge 控制面板的 API 密钥

在 .cursor-plugin/plugin.json → variables 中声明，并且仅在 mcp.json 中以 ${BROWSEBRIDGE_API_KEY} 的形式引用。

隐私与安全

参见 PRIVACY.md 和 SECURITY.md。

仓库布局

.cursor-plugin/plugin.json
mcp.json
assets/logo.svg
README.md
LICENSE
PRIVACY.md
SECURITY.md
SUPPORT.md