用途 real-browser-mcp 面向编码与验证循环：当你在真实 Chrome 中已经登录、已进入预发布环境、已复现某个 Bug 的页面时，让 AI 智能体直接操作这个浏览器来验证结果，而不是另开一个无 Cookie 的全新浏览器。项目定位是“MCP 服务器 + Chrome 扩展”的桥接方案：AI 客户端通过 MCP 协议发指令，真实 Chrome 负责执行，会话数据保留在本地。
主要能力 提供 18 个工具，按用途分组，支持点击、输入、导航、截图、快照等操作。连接中断会自动重试（指数退避 1 秒到 30 秒），每 10 秒进行 ping/pong 健康检查，并为不同工具设置超时（点击 5 秒，导航 60 秒）。支持同时运行两个服务器实例（不同端口）。自带配置文件，可教会智能体“先快照、再操作、后验证”的工作流，并处理下拉菜单、截图与快照的选择。仓库以 Agent Plugins 1.0.0 包形式发布，包含 plugin.json、mcp.json 和 skills/real-browser-control/。
使用方式 1）添加 MCP 服务器：可在 Cursor 中一键安装，或手动在 Cursor 设置 > MCP > 添加新 MCP 服务器；Claude Desktop 编辑配置文件 claude_desktop_config.json（macOS 路径 ~/Library/Application Support/Claude/，Windows 路径 %APPDATA%\Claude\）；Windsurf 在设置 > MCP 中添加相同 JSON 配置。任何兼容 MCP 的客户端均可。 2）安装 Chrome 扩展：从源码加载时，打开 chrome://extensions 启用开发者模式，点击“加载已解压的扩展程序”，选择仓库中的 extension/ 文件夹，点击工具栏的 Real Browser MCP 图标，绿色圆点表示已连接，灰色表示等待服务器。 3）Cursor 本地插件：克隆仓库后复制或符号链接到 ~/.cursor/plugins/local/real-browser-mcp 并重载窗口，仍需连接 Chrome 扩展。 4）教智能体工作流：运行一条命令生成规则文件，之后在对话中输入 /check-browser 或说“check the result in my browser”即可；Claude Code 会自动发现项目根目录的 AGENTS.md。
适用场景 适合在已登录的预发布环境、企业 SSO 已手动完成的页面、需要实时会话状态的调试与验证场景。项目明确建议：需要可重复的 CI 自动化时使用 Playwright；需要浏览器内已认证的实时状态时使用本工具。
限制 必须安装 Chrome 扩展，单独 MCP 服务器无法看到或控制 Chrome；扩展运行在普通 Chrome 配置文件中，因此智能体可点击、输入并读取已连接标签页中可见内容（包括已登录应用），测试不可信网站时建议使用专用配置文件或标签页，且不要将自动化指向含敏感数据的标签页除非接受该风险。该工具不是“智能体浏览器”（不新建无头/云浏览器），也不是 Playwright 或 Chrome DevTools MCP 的替代；Chrome 136+ 已阻止对默认用户配置文件进行远程调试，本工具改用 localhost WebSocket 扩展桥接。所有通信在本地进行，无云端、无代理，工具返回的页面内容仍会进入你的 AI 客户端。价格、收费、平台支持范围等细节资料中未提供。
