← 返回目录

Playwright MCP

官方

让 AI 智能体通过结构化无障碍树控制浏览器

查看安装方法 ↓ 横向对比 GitHub 源仓库 ↗

分类: 浏览器自动化第 25 / 32
Stars: ★ 97.5k 非常热门
传输方式: stdio（本地进程）
运行环境: Node.js
凭据: 无需凭据
许可证: Apache-2.0
最近提交: 3 天前

43FMRS · D

Playwright MCP 是微软官方生态中面向 AI 智能体的浏览器控制服务器，基于无障碍快照而非截图驱动交互，通过 npx 以 stdio 方式接入主流 MCP 客户端；README 未提供具体工具名称清单，因此工具列表暂缺。

最强项 · 维护活跃度 17/20 最弱项 · 可靠性 3/20

可靠性

3/20

安全与权限

8/20

维护活跃度

17/20

文档质量

9/20

安装易用性

6/20

查看各项评分依据

可靠性 3/20: 关键问题：本条目声明的服务器路径为仓库根目录，但README明确说明真正的MCP服务器实现（工具、accessibility snapshot、元素ref交互等）位于另一个独立仓库 github.com/microsoft/playwright-mcp，并通过 npx @playwright/mcp@latest 单独分发。microsoft/playwright 仓库本身是Playwright测试框架/浏览器自动化库，没有提供MCP manifest（标记为“未缓存”），也没有任何证据表明仓库根目录存在MCP server初始化逻辑、工具列表或握手实现。无法验证声明的工具与实际行为是否一致，也无法确认启动流程。按静态核查规则，缺乏可验证证据只能扣分，不能假设最佳情况，故评为低分。
安全与权限 8/20: 由于本仓库根目录并非实际MCP服务器代码所在地，无法在此评估具体的权限范围、凭据处理或危险操作确认机制。未发现红线级证据（如恶意代码、凭据窃取或无确认的破坏性默认行为），因此不适用0-4的红线分数。但Playwright库本身具备浏览器自动化能力（网络拦截、文件系统写入、任意页面导航等），若MCP server确实复用这些能力，其外部网络访问和本地副作用需要额外披露，而当前材料未提供这些信息，故只能给中等偏低分数。
维护活跃度 17/20: 仓库层面证据充分：Apache-2.0许可证明确、94512星标、148个开放issue、未归档，由Microsoft维护，属于业界广泛使用的活跃项目，版本号（Chromium/Firefox/WebKit）在README中持续更新，表明发布节奏活跃。这些是仓库整体治理和维护活跃度的可靠信号。
文档质量 9/20: README结构清晰，覆盖多种使用路径（Test、CLI、MCP、Library、VS Code扩展）并提供代码示例，整体文档质量较高。但针对MCP这一具体能力，文档仅给出最基础的安装JSON片段和一个交互示例，具体工具参数、限制、故障排查、成本等内容均需要跳转到外部仓库（playwright-mcp）查看，本仓库内不包含完整的MCP专属文档，存在明显的文档缺口。
安装易用性 6/20: README给出的MCP安装命令（npx @playwright/mcp@latest）实际指向一个不同的npm包和不同的GitHub仓库，而非当前评审对象（microsoft/playwright仓库根目录）。在当前仓库中找不到与声明路径相符的可执行MCP server入口或配置文件用于验证安装流程的真实性和完整性，按静态核查规则不能因文档内步骤看起来简单就给高分。

静态评测 · 未实际运行收录于 2026-08-26

查看 FMRS 评分方法 →

选型与风险

能访问什么访问网络控制浏览器

适合谁

希望通过 LLM 驱动浏览器执行开放式网页任务的用户
已经在使用 Claude Desktop、VS Code、Cursor 或 Windsurf 等 MCP 客户端的开发者
需要跨 Chromium、Firefox、WebKit 进行浏览器自动化而不想手写测试脚本的场景

不适合谁

需要完整端到端测试运行器（并行执行、追踪查看器、断言重试）的团队，应使用 Playwright Test 而非 MCP 服务器
更看重 token 效率、不想加载完整工具架构和无障碍树的编码代理场景，README 建议改用更轻量的 Playwright CLI
对浏览器会话、Cookie 或本地文件系统访问有严格隔离要求、不希望智能体获得实际浏览器控制权的场景

所需权限

需要本地 Node.js/npx 环境以启动服务器进程
需要下载并运行 Chromium/Firefox/WebKit 浏览器二进制文件
需要出站网络访问以加载智能体请求导航的目标网页

风险与副作用

服务器授予智能体对真实浏览器的完整控制权，若被恶意提示词误导，可能访问或提交非预期网站的内容
若浏览器会话中已保存登录状态（如 storageState），智能体可能接触到已认证的账户数据
README 未说明该 MCP 服务器自身的身份验证或访问控制机制，安全边界主要依赖宿主客户端和用户对目标网址的把控

安装接入

准备工作

运行环境：Node.js

在支持 MCP 的客户端（如 VS Code、Cursor、Claude Desktop、Windsurf 或 Claude Code）的配置中添加一个 MCP 服务器条目，命令为 npx，参数为 ["@playwright/mcp@latest"]；VS Code 用户也可以使用仓库提供的一键安装徽章；Claude Code 用户可运行 claude mcp add playwright npx @playwright/mcp@latest。首次运行时 npx 会拉取最新版本的包并启动本地进程，客户端通过标准输入输出（stdio）与其通信。

claude_desktop_config.json

{"mcpServers":{"playwright":{"command":"npx","args":["@playwright/mcp@latest"]}}}

以 Claude Desktop 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

{
  "servers": {
    "playwright": {
      "command": "npx",
      "args": [
        "@playwright/mcp@latest"
      ]
    }
  }
}

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

claude mcp add playwright -- npx @playwright/mcp@latest

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

在 MCP 客户端（如 VS Code 或 Claude Desktop）中按文档添加配置后，工具列表中应出现 Playwright 的浏览器控制工具；然后输入“导航到 https://demo.playwright.dev/todomvc”，若返回页面的无障碍快照即证明连接成功。

常见排障

确认已安装 Node.js 并可执行 `npx @playwright/mcp@latest`
检查 MCP 客户端配置文件中的 command/args 是否与文档示例一致
确认客户端支持 MCP 的 stdio 传输方式
若浏览器无法启动，检查是否需要执行 Playwright 的浏览器安装步骤，以及目标网站的网络可达性

试试这样问

连接成功后，可以直接对 AI 助手这样说：

导航到 https://demo.playwright.dev/todomvc 并添加几个待办事项。
打开 https://playwright.dev/ 并截图当前页面。
在 https://demo.playwright.dev/todomvc 中勾选所有已完成的待办项。
填写示例登录表单中的邮箱和密码字段并提交。

使用场景

让编码助手或聊天机器人在网页上执行导航、点击、表单填写等操作

无需截图或视觉模型，通过结构化无障碍树驱动网页自动化任务

让 AI 智能体验证网页流程（如提交表单、浏览多步骤页面）

支持客户端

Claude Desktop

Claude Code

VS Code

Cursor

Windsurf

依据项目文档列出，未经本站实测。

详细介绍

Playwright MCP 是微软 Playwright 项目下的 Model Context Protocol 服务器，通过 npx 启动本地进程，为 AI 智能体提供对 Chromium、Firefox 和 WebKit 的完整浏览器控制能力。智能体通过结构化的无障碍(accessibility)快照而非视觉截图来理解页面内容，并使用元素引用（如 e5、e10）进行点击、输入等交互。文档中提到其工具覆盖导航、表单填写、截图、网络模拟和存储管理等场景。该服务器由 microsoft/playwright-mcp 仓库维护，并在 microsoft/playwright 官方仓库的 README 中作为官方生态项目之一被引用和推荐。