Puppeteer Real Browser MCP Server 是一款把 Chromium 真实浏览器内核搬进 MCP 协议的"可操控型"服务器。它面向需要在前端页面上完成点击、滚动、登录、截图、抓取、填表等动作的 AI Agent，让模型直接以"类真人"方式驱动浏览器，而不是只发 HTTP 请求。
在典型用法里，AI 可以让浏览器打开任意 URL，等待元素渲染后执行 点击、输入、拖拽，并把页面 DOM、控制台日志、网络响应回传给模型进行下一步决策。相比无头爬虫，它能更好地处理 JavaScript 动态渲染、Cookie 维持、验证码弹窗以及需要交互才能看到的内容，因此常被用于价格监控、表单自动化、端到端测试辅助和需要登录态的内部数据同步等场景。
它能接什么
- 支持本地或远端的 Chromium / Chrome / Edge 实例，可与 Playwright、Chrome DevTools Protocol 配合使用。
- 可作为 MCP Server 接入 Claude Desktop、Cline、Cursor 等支持 MCP 的客户端，AI 通过工具调用即可"上网"。
- 常见能力包括：打开页面、点击、键入、截图（含整页与元素级）、获取可访问性树与文本、执行脚本片段、保存/读取 Cookie、处理
alert/confirm与文件下载等。
是否需要密钥或额外账号
- 服务端本身一般不需要 API Key，只要本地装有兼容版本的 Chrome/Chromium 即可启动；如果你选用托管的远程浏览器服务（例如 Browserless、Browserbase 等），则需向对应平台注册并获取访问 Token，并在 MCP 配置里填入。是否需要鉴权请以官方文档和具体部署方式为准。
使用须知
由于它能绕过一部分前端反爬机制，请仅将其用于自己有权限的站点、自动化测试或合规的数据采集任务，避免用于违反目标网站 ToS、隐私法规或进行未授权的批量抓取。不同分支对浏览器版本、Node 版本和 MCP 协议版本的要求略有差异，部署前建议对照仓库 README 确认依赖。
