Virtual Browser

简体中文

English

简体中文

English

主题

MCP 协议 ​

Virtual Browser 专业版提供基于 Model Context Protocol (MCP) 的 HTTP 端点，支持 Cursor、Claude Desktop 等 AI 工具通过标准协议控制浏览器环境，并与 Playwright MCP 能力结合完成页面自动化。

专业版功能

MCP 与 REST API 相同，需登录专业版会员后在客户端 API 菜单获取地址。

端点地址 ​

服务启动后，MCP 地址格式为：

http://localhost:{port}/mcp
  • {port} 为客户端 API 菜单显示的本地端口（非固定 9000）
  • 传输方式：Streamable HTTP（可流式传输的 HTTP）

在客户端复制「MCP」一栏的完整 URL 即可使用。

内置工具 ​

Virtual Browser MCP 服务注册以下工具（名称以实际连接为准）：

工具说明
getBrowserList获取浏览器环境列表（id、名称、分组等）
launchBrowser启动指定环境，返回 debuggingPort 供 Playwright 连接
stopBrowser关闭指定环境

启动浏览器后，服务会尝试绑定 Playwright MCP，以便 AI Agent 通过 CDP 操作页面。

在 Cursor 中配置 ​

  1. 启动 Virtual Browser 并打开 API 页面，确认 MCP URL 可用（非「仅 VIP 用户可用」）
  2. 打开 Cursor Settings → MCP，添加 HTTP 类型服务器
  3. 将 API 页复制的 MCP 完整 URL 粘贴为 server URL（形如 http://localhost:{port}/mcp）
  4. 保存后重启 Cursor 或刷新 MCP 连接；在 Agent 中应能看到 getBrowserList、launchBrowser 等工具

示例（URL 以客户端为准，勿照抄端口）：

json
{
  "mcpServers": {
    "virtual-browser": {
      "url": "http://localhost:9000/mcp"
    }
  }
}

TIP

若使用 CLI 无人值守启动，请先执行 VirtualBrowser.exe --cli，再用 --cli-print --cli-json 获取 port 后拼接 /mcp。

在 Claude Desktop 中配置 ​

  1. 确认已开通 专业版 且 API 页 MCP 地址可用
  2. 编辑 Claude Desktop 配置文件（路径因系统而异，见 Anthropic 文档）
  3. 在 mcpServers 中加入与 Cursor 相同的 HTTP URL
json
{
  "mcpServers": {
    "virtual-browser": {
      "url": "http://localhost:9000/mcp"
    }
  }
}
  1. 重启 Claude Desktop，在对话中让 Agent「列出 Virtual Browser 环境并启动 id=1」验证工具是否可用

示例对话（Cursor / Claude） ​

  1. 列出环境：「调用 getBrowserList，告诉我有哪些浏览器环境。」
  2. 启动并打开网页：「用 launchBrowser 启动 id 为 1 的环境，再通过 Playwright 打开 https://example.com。」
  3. 结束：「stopBrowser 关闭 id 1。」

若启动后页面自动化不可用，请确认环境已成功 launch，并参考 Playwright 接入。

故障排查 ​

现象处理
仅 VIP 用户可用登录并开通 专业版
连接失败 / 404客户端未启动或 port 错误；核对 API 页 MCP URL
工具列表为空重启客户端与 MCP 客户端；检查防火墙是否拦截 localhost
Session 错误使用支持 Streamable HTTP 的 MCP 客户端版本；勿混用旧版 SSE 配置

与 REST API 的关系 ​

方式适用场景
REST API脚本、Playwright/Selenium 直连 CDP、传统自动化
MCPAI Agent、自然语言驱动、与 Cursor 等 IDE 集成

两者共用同一本地 HTTP 服务端口；REST 路径为 /api/*，MCP 路径为 /mcp。

相关文档 ​