Agent Skills
返回列表
🤖

Microsoft Playwright MCP

AI Agent 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,在 AI 助手中安装 @user_3c6cb52e/microsoft-playwright-mcp,并按页面提示完成接入。

技能介绍

解决什么问题

在 MCP 客户端里驱动浏览器时,最常见的做法是让模型盯着截图猜页面状态。截图丢掉了 DOM 的结构信息:控件没有稳定的标识、表单字段的可访问性树被压缩成像素、异步渲染完成与否无从判断。结果是导航不可靠、填表靠运气、断言只能凭感觉。Microsoft Playwright MCP 的思路是反过来——把 Playwright 的浏览器自动化能力通过 Model Context Protocol 暴露出去,让 agent 拿到的是结构化的页面访问,而不是一张需要二次解释的图片。

核心能力与工作方式

它把 Playwright 包装成一个 MCP server,模型通过协议调用一组面向页面操作的工具,核心覆盖四件事:

  • 可靠导航:等待网络空闲、路由跳转、页面加载完成之后再返回结果,避免“还没渲染完就开始操作”的竞态。
  • 表单填充:按标签、占位符或角色定位输入控件,逐项写入并提交,适合登录、搜索、向导这类多步流程。
  • DOM 检查:直接读取文档结构与元素属性,用于核对页面状态、抓取文本、验证某个节点是否存在。
  • 测试式自动化:把操作写成可重复的流程,类似写集成测试的心智模型,而不是一次性的即兴脚本。

接入端很宽:VS Code、Cursor、Windsurf、Claude Desktop、Goose、Junie 等任意 MCP client 都能把它当作标准 server 挂载。上游还提供了一个扩展开关,可以把工具连接到用户已经在运行的浏览器实例上,而不是每次另起一个临时浏览器。

适用边界与注意点

它不是无脑可用的。首先需要 Node.js 18 或更高版本,低于这个版本跑不起来。其次,连接已有浏览器的扩展模式只支持 Edge 与 Chrome,且要求先装好 Playwright Extension,并通过环境变量 PLAYWRIGHT_MCP_EXTENSION 提供路径;这条路径走不通时,只能退回到它自己启动的浏览器。

另外,工具的能力边界由 Playwright 决定:跨域 iframe、权限弹窗、验证码、文件上传、Canvas 渲染这类场景仍然需要额外处理。它给你的是可控的页面访问,不是绕过站点防护的魔法。适合做内部工具的自动化验证、重复性回归流程,以及需要精确 DOM 断言的任务;如果目标是绕开登录态或对抗反爬,这套工具并不合适。

使用场景

  • QA 工程师在 CI 前用 agent 打开登录页,填表提交并检查跳转后的 DOM 是否包含预期内容。
  • 前端开发者在 VS Code 里通过 MCP client 驱动浏览器,复现表单填写与页面导航问题。
  • 测试人员需要用 agent 打开运行中的 Edge/Chrome 实例,连接扩展后执行回归流程。
  • 自动化工程师想用 Playwright MCP 获取结构化页面状态,而不是截图后再解释元素位置。

适合人员

  • 负责回归测试的 QA 工程师,需要在 MCP client 中完成可靠导航、表单填写与断言。
  • 构建 AI agent 的开发者,希望为模型提供 DOM 检查和页面状态获取能力。
  • 在 VS Code/Cursor/Windsurf 工作的前端开发者,想直接调试浏览器自动化流程。
  • 维护 Playwright 测试套件的工程师,需要测试式自动化与结构化页面访问。