跳到主要内容
NAVSMAP

MCP SERVER

Playwright MCP

让 AI 操作浏览器并读取页面结构，辅助跟练、调试与测试。

NPM · Node.js中级 · 需配置依赖

接入前准备

Node.js 18+（官方 package.json 声明），建议使用 Node.js 22 或更新的受支持 LTS。
npm / npx 与本地浏览器运行依赖；首次运行需要下载包。
支持本地 stdio MCP 的客户端；CLI 示例需要 Claude Code。
隔离会话不会继承日常浏览器登录，目标站点登录需自行完成。

能力介绍

Microsoft 官方 Playwright MCP 提供浏览器导航、页面结构快照、点击、输入与截图等工具。通过可访问性树理解页面，适合持续观察网页并逐步完成操作。

适用场景

  • 检查一个开发页面的布局与交互流程。
  • 在测试环境跟练表单填写、导航和按钮状态。
  • 收集页面快照与截图，辅助定位复现步骤。

接入步骤

  1. 准备 Node.js 与 npx。官方包声明 Node.js 18+；新部署建议使用 Node.js 22 或更新的受支持 LTS。
  2. 选用系统对应配置，合并至客户端的 mcpServers。首次启动需要从 npm 下载包，并准备可用浏览器及其依赖。
  3. 重启客户端，在 MCP 工具列表确认 playwright 已连接。
  4. 先打开公开演示页或自己的测试站，要求 AI 读取页面结构，再逐项验证点击与输入。

会话与操作边界

示例使用 --isolated，浏览器状态仅保留在当前隔离会话中；关闭会话后登录状态不会持续保存，也不会直接复用你日常浏览器的登录。它不是只读工具，可以提交表单或改变网页数据。交易、删除、发布等操作应先确认目标与影响，测试优先使用独立环境。

Playwright MCP 本身不是安全沙箱。它提供浏览器工具，不保证自动生成的操作步骤或测试结论正确；验证码、登录与站点权限仍可能需要人工处理。此页仅核验官方资料，未执行第三方客户端安装或在线操作。

官方资料

官方仓库与客户端配置 · Node.js 版本声明 · 本地 MCP 客户端配置