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 中配置
- 启动 Virtual Browser 并打开 API 页面，确认 MCP URL 可用（非「仅 VIP 用户可用」）
- 在 Cursor 的 MCP 配置中添加 HTTP 类型服务器，填入 MCP URL
- 按 MCP 客户端要求完成
initialize会话（需携带mcp-session-id等头，由 SDK 自动处理）
TIP
若使用 CLI 无人值守启动，请先执行 VirtualBrowser.exe --cli，再用 --cli-print --cli-json 获取 port 后拼接 /mcp。
与 REST API 的关系
| 方式 | 适用场景 |
|---|---|
| REST API | 脚本、Playwright/Selenium 直连 CDP、传统自动化 |
| MCP | AI Agent、自然语言驱动、与 Cursor 等 IDE 集成 |
两者共用同一本地 HTTP 服务端口；REST 路径为 /api/*，MCP 路径为 /mcp。