ARTICLE DETAIL

资讯详情

深耕网站建设与运营推广的一线实战洞察。

在 Cursor 中运行 invisible_playwright_mcp:mcp.json 配置、首批提示词与首次运行问题排查

在 Cursor 中运行 invisible_playwright_mcp:mcp.json 配置、首批提示词与首次运行问题排查 人工智能AI Agent浏览器控制GUI 自动化MCP 服务【免费下载链接】invisible_playwright_mcpPlaywright MCP server undetected by anti-bots and captchas: AI agent browses the web on anti-detect stealth Firefox, Python, undetected browser automation, scraping, computer use.项目地址https://gitcode.com/GitHub_Trending/jo/invisible_playwright_mcp点击查看免费下载本篇指南以 Cursor 编辑器为客户端讲解如何把 invisible_playwright_mcp 的隐形浏览器接入 Cursor包括项目级与全局级两处 mcp.json 配置的取舍、Cursor 自动选择工具与默认审批的运行机制、两条可以立刻上手验证的首批提示词以及首次运行时最常遇到的五个问题的排查路径。读完你就能在 Cursor 里让 AI 代理驱动一台真实的补丁版 Firefox——点击、输入、截图、读页面——并用它来驱动和测试你自己的 Web 应用。平台边界先确认你的机器在支持列表里在动手配置之前先确认一个硬性前提。invisible_playwright_mcp 的引擎目前为 Windowsx86_64和 Linuxx86_64、arm64提供构建没有 macOS 构建。也就是说在 Mac 上 Cursor 可以正常启动 MCP server但 server 会发现没有任何引擎可以运行——It is a Mac. No engine build; nothing to debug. 这一组合Cursor invisible_playwright_mcp目前只在 Windows 和 Linux 上是可用的。如果你在 macOS 上遇到了服务器启动了但浏览器毫无反应不必继续排查这是平台支持边界而非配置错误。关于引擎本身的更多事实可以核对 README.md 与 server.json包名是io.github.feder-cr/invisible-playwright-mcp以 stdio 传输方式运行发布到 PyPI由uvx启动。Cursor 读取 MCP 的方式项目级与全局级两处配置Cursor 从一个 JSON 文件读取 MCP 服务器配置按 Cursor 自己的文档定义有两个层级项目级.cursor/mcp.json放在项目仓库内工具仅对该项目生效全局级~/.cursor/mcp.json放在用户主目录工具对所有项目可用。两个位置粘贴的配置块完全相同配置块本身存放在本仓库的 mcp-server.md 页面原文即链接而非复制该页本页负责讲 Cursor 侧的故事。这个配置块只告诉客户端如何启动 server内容形如{ mcpServers: { invisible_playwright_mcp: { type: stdio, command: uvx, args: [invisible-playwright-mcp] } } }这正是仓库根目录 mcp.json 中实际携带的配置command: uvx、args: [invisible-playwright-mcp]、stdio 传输。server 名键名如invisible_playwright_mcp或 mcp-server.md 示例里的stealth可以随意起不影响行为。启动的前提是先安装好uv——README 的安装章节给出了 Windows PowerShell 与 Linux 两条安装命令装好后uvx才能被找到。需要额外的代理、种子、配置文件等设置时把它们放在 server 条目的env下详见下文环境变量一节例如{ mcpServers: { invisible_playwright_mcp: { command: uvx, args: [invisible-playwright-mcp], env: { STEALTHFOX_PROXY: http://user:passproxy.example.com:8080, STEALTHFOX_SEED: 4242 } } } }层级选择取决于受众全局级适合个人研究工具——浏览器在所有项目里都可用项目级跟随仓库走适合希望agent 能驱动我们的 staging 应用成为团队 checkout 体验的一部分。一个关键的安全结论server 配置块只含命令与参数不含任何 key 或 secret——模型由 Cursor 自带invisible_playwright_mcp 这边没有任何需要注册的东西——所以把它提交进仓库是配置提交里最安全的一类。是否愿意把编辑器工具链放进仓库是团队决策而不是安全问题。需要说明的是虽然配置块本身无 secret但若你在env里填写了代理认证信息请留意该 JSON 文件会被提交敏感信息应通过环境变量而非仓库文件传递。一个浏览器在编辑器里真正能做什么诚实的边界Cursor 的 agent 本来就能读你的代码、能搜索网页。一台可驱动的浏览器是另一种能力值得精确界定它什么时候值得存在——因为对一次快速查文档来说它是杀鸡用牛刀需要驱动页面而不是抓取页面的研究。版本切换器后面的文档、滚动加载的 changelog、需要连点三个产品页的对比页——任何答案需要你在页面上操作而不是一次性下载下来的场景浏览器才派得上用场。用一个贴近真实的浏览器测试你自己的 Web 应用。这是编辑器原生场景把 agent 指向你的 dev server让它注册一个用户、走一遍 checkout 向导、或者在你刚写的表单上反复触发校验然后汇报它看到了什么。浏览器是真实的补丁版 Firefox它渲染出的内容、发出的事件与一个人用真实浏览器时一致——真实按键与点击而非脚本注入的值。由于同一个 agent 同时看得到你的代码在应用里复现这个 bug然后看一下 handler 告诉我为什么可以是一段对话里完成的事。读取那些对普通抓取工具回推的页面。一个对简单 HTTP fetch 几乎不返回内容的页面经真实浏览器可能读得很好。当站点回推超出这个程度时诚实的归因地图在 why-does-my-ai-agent-get-blocked.md没有任何工具能保证带你穿过它。它不添加的是速度。一个浏览器会话加上模型推理轮次是慢而审慎的路径。如果一条curl就能回答的问题浏览器就是错误的工具——这个边界正是 ai-browser-agents-vs-traditional-scraping.md 长篇论述的分界线。Cursor 如何运行这些工具自动选择、默认审批、可开关关于运行侧Cursor 自己的文档明确了两个关键行为agent 在判断工具相关时会自动使用 MCP 工具且默认情况下每次运行工具前都会征求你的批准并提供设置让白名单工具免审批运行。服务器也可以从 Cursor 的设置里直接开关无需删除配置。实际后果是你不直接调用工具而是描述目标、逐步批准如果你不想在某个项目里继续用浏览器开关优于编辑 JSON。工具本身分为两个家族浏览器工具browser_open及其同族browser_close、browser_list、browser_status页面工具browser_navigate、browser_read_text、browser_snapshot、browser_click、browser_type、browser_take_screenshot等。完整清单含browser_read_html、browser_watch、browser_click_at、browser_select_option、browser_press_key、browser_evaluate见 mcp-server.md 的工具表。你在 agent 的工作转录里看到的正是这些名字每一项在放宽之前都由一次批准把守。从源码看actions_help.py 把这些调用翻译成一行可读摘要browser_navigate显示 URL、browser_click显示 selector、browser_type对疑似密码字段只显示hidden, N characters这也是为什么你可以在 Cursor 里舒服地旁观每一步在做什么。首批提示词先测安装再测你自己的应用第一条提示词是安装测试所以它应该足够小、足够可检查Open https://books.toscrape.com/ and tell me the title and price of the first book on the page.这个示例站点是专门用于练习的沙箱。如果这条成功了整条链路就通了server 启动、引擎就位、页面加载、文本读取。然后是编辑器原生场景指向你自己的东西Start the dev servers page at http://localhost:3000. Register a new user through the signup form with placeholder data, do not submit the final step, and list every validation message you encounter on the way.关于这条提示词有两点说明Do not submit不要提交是刻意的把会产生后果的那一下点击留给真人是 ai-agent-fill-out-forms.md 的一贯建议一旦数据是真实的它同样适用于你自己的应用localhost 目标让你最初的几次会话停留在犯错不花钱的地方。浏览器默认是无头headless模式因此 agent 的截图browser_take_screenshot就是你观察发生了什么的窗口。当你想直接看着它驱动你的应用时server 从自己的环境读取STEALTHFOX_HEADLESS0设置在同一份配置块的env里{ mcpServers: { invisible_playwright_mcp: { command: uvx, args: [invisible-playwright-mcp], env: { STEALTHFOX_HEADLESS: 0 } } } }其余环境变量在 mcp-server.md 有完整文档其中持久化 profile 目录STEALTHFOX_PROFILE_DIR登录态跨运行保留和固定身份种子STEALTHFOX_SEED同一种子同一指纹是反复测试时最有用的两个。从源码看这份设置的传播路径是清晰的cli.py 的浏览器选项--headed等在 runner.py 的child_env中被映射为STEALTHFOX_HEADLESS0等环境变量交给引擎而 mcp/plan.py 用env.get(STEALTHFOX_HEADLESS, 1) ! 0决定一次启动是否无头——默认值是1即无头。常见首次运行问题与排查第一条触碰页面的提示词回答引擎正在下载。引擎约有四分之一 GB由 server 在 Cursor 启动它的那一刻起自行抓取在下载完成前请求浏览器得到的是下载进度agent 会在一分钟后再问一次。想把它提前到你自己选定的时刻在终端里预取一次uvx invisible-playwright fetch引擎会被缓存并与进入 invisible_playwright_mcp 的每一条其他路径共享。源码侧的解释在 engine.py这个下载此前发生在README 的 fetch 行或第一次浏览器启动两处之一而后者在 MCP 客户端看来就是一次卡住数分钟的工具调用现在它成了 server 进程启动后自行做一次的事情browser_open在引擎未就绪时只回报进度并要求再次调用任何工具调用都不会被它阻塞。FETCH_BY_HANDuvx invisible-playwright fetch在 engine.py 被定义为一处命名保证错误提示与 setup 技能说同一句话。server 没有出现在 Cursor 的 MCP 列表里。检查 JSON、确认文件位于上文两个文档位置之一、并确认uvx对 Cursor 可解析配置是用uvx启动 server 的所以uv 必须装在编辑器能找到它的地方——这并不由它在某个特定 shell 里能用来保证。安装方式见 README.md。工具都在但每一步都要求批准。这就是文档化的默认行为在你还处于了解浏览器能做什么的阶段时请保持它开启。Cursor 的设置允许在你信任该模式后加入白名单要放宽也是刻意为之而不是第一天就放宽。是 Mac。没有引擎构建没什么可排查的——回到本文开头的平台边界。某个公开站点加载异常或回推。在碰配置之前先把层次分开本地一半看 browser-problem-or-model-problem.md站点一半看 why-does-my-ai-agent-get-blocked.md。注意 mcp-server.md 的 Notes 也写明这是一个浏览器不是验证码求解器——它不会替你解谜或绕过挑战它只是让一次普通的 Firefox 会话看起来像真的。常见问题速答怎么把 invisible_playwright_mcp 的浏览器加进 Cursor把 mcp-server.md 里的配置块粘贴到项目内的.cursor/mcp.json或全局的~/.cursor/mcp.json两个位置都符合 Cursor 自己的 MCP 文档。无 key、无注册思考由 Cursor 的模型完成。配置应该项目级还是全局级个人研究工具选全局团队希望能力随仓库版本化时选项目级。配置块不携带 secret所以这是作用域问题不是安全问题。Cursor 的 agent 会自己使用浏览器吗它在判断相关时会自动选择 MCP 工具但默认每次工具运行都等待你的批准白名单化以自动运行是之后你主动选择加入的设置。这在编辑器里到底擅长什么通过真实浏览器驱动和测试你自己的 Web 应用以及需要在页面上操作而非抓取页面的研究。查个资料普通搜索就能回答时跳过浏览器。为什么第一条指令说引擎正在下载引擎下载约四分之一 GB由 server 在 Cursor 启动它时开始browser_open持续报告进度直到完成。在终端执行uvx invisible-playwright fetch可以把这笔成本挪到你选定的时刻。我能看着浏览器工作吗默认不能——它是无头的截图工具就是你的窗口。在 server 的环境块里设置STEALTHFOX_HEADLESS0就能得到真实窗口在它驱动你自己的应用时这确实有用。继续阅读配置块、完整工具表与环境变量mcp-server.md其它客户端接入方式running-invisible-playwright-mcp-with-claude-code.md、running-invisible-playwright-mcp-with-claude-desktop.md让 AI agent 填表ai-agent-fill-out-forms.md把 agent 采集的数据导出为 CSVhow-to-extract-data-to-csv-with-an-ai-agent.md被拦截时的分层排查browser-problem-or-model-problem.md、why-does-my-ai-agent-get-blocked.md最后借用本 wiki 的一句话收尾invisible_playwright_mcp 在 Cursor 里最强、也最不引人注目的用法是让 agent 去填你自己那半成品的表单——填得很糟然后精确地告诉你它在哪一步断了。赞分享人工智能AI Agent浏览器控制GUI 自动化MCP 服务【免费下载链接】invisible_playwright_mcpPlaywright MCP server undetected by anti-bots and captchas: AI agent browses the web on anti-detect stealth Firefox, Python, undetected browser automation, scraping, computer use.项目地址https://gitcode.com/GitHub_Trending/jo/invisible_playwright_mcp点击查看免费下载相关推荐Freebuff 在 Windows 上首次运行提示 Failed to determine latest version 怎么排查Freebuff 在 Windows 上首次运行提示 Failed to determine latest version 怎么排查 在 Windows 上用人工智能大模型AI Agent代码智能体CLI在 Cline 中接入 invisible_playwright_mcp 的隐形浏览器MCP 配置、审批策略与首次运行排查在 Cline 中接入 invisible_playwright_mcp 的隐形浏览器MCP 配置、审批策略与首次运行排查 本文以 docs/running人工智能AI Agent浏览器控制GUI 自动化MCP 服务Czkawka 磁盘清理实战指南3 条命令编译4 类清理收回空间Czkawka 磁盘清理实战指南3 条命令编译4 类清理收回空间 Czkawka 是一款 Rust 编写的开源磁盘清理工具一次扫描找出重复文件、空文件夹、桌面应用上一篇open-pencil Vue SDK 的 useToolbarState无 ToolbarRoot 的响应式工具栏状态与移动端分类翻页下一篇网盘直链下载助手终极指南三步告别限速烦恼解锁九大网盘真实下载链接创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
返回列表