microsoft GitHub avatar

playwright-mcp

TypeScript
浏览器自动化MCP服务microsoft最近推送 2026年11月19日
MCP 与工具接入Apache-2.039.9k3,4520 issues7 天 +343

AI 分析 · 由大模型根据 README 与仓库数据生成 · 2026年11月17日

用 Playwright 为 AI 助手提供浏览器自动化能力的 MCP 服务器。

这是微软开源的 Playwright MCP 服务器,基于 Playwright 实现浏览器自动化。它通过结构化的可访问性快照让大模型与网页交互,无需截图或视觉模型。

推荐指数

5.0

微软官方出品、生态成熟,是给 AI 助手接入浏览器操作的首选方案之一。

近 7 天

+343

新增 Star

总 Star 排名

#147

雷达追踪的 3,958 个 AI 仓库中

创建于

2025

2025年3月22日

核心亮点

  • 1结构化交互

    基于可访问性树而非像素,模型无需视觉能力即可操作网页。

  • 2轻量快速

    不依赖截图和视觉模型,数据量小、响应快。

  • 3结果确定

    工具调用基于结构化数据,避免截图方案中的歧义。

  • 4客户端广泛

    支持 VS Code、Cursor、Claude Desktop、Goose 等主流 MCP 客户端。

  • 5官方维护

    由微软 Playwright 团队维护,与 Playwright 生态同步更新。

适用场景

  • AI 编码助手操作网页

    例如:在 Cursor 中让 AI 打开本地页面、点击按钮并读取结果。

  • 探索式自动化

    例如:让 AI 自主浏览网站、填写表单并提取页面信息。

  • 自愈测试

    例如:测试失败时由 AI 检查页面结构并调整定位方式。

  • 长时自主工作流

    例如:需要持续保持浏览器上下文的自动化任务。

它是怎么工作的

  1. 第 1 步

    启动 MCP 服务器

    通过 npx 运行 @playwright/mcp,以 stdio 方式与客户端通信。

  2. 第 2 步

    客户端连接

    在 MCP 客户端配置中注册该服务器,客户端即可发现浏览器工具。

  3. 第 3 步

    模型调用工具

    模型根据任务调用导航、点击、输入等浏览器操作工具。

  4. 第 4 步

    读取可访问性快照

    服务器返回页面结构化快照,模型据此决定下一步操作。

快速上手

  1. 1

    标准配置

    在多数 MCP 客户端中添加以下配置即可。

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

    Claude Code 安装

    使用 Claude Code CLI 一条命令添加。

    claude mcp add playwright npx @playwright/mcp@latest
  3. 3

    Codex 安装

    使用 Codex CLI 添加服务器。

    codex mcp add playwright npx "@playwright/mcp@latest"
  4. 4

    Cursor 安装

    在 Cursor 设置中手动添加命令 npx @playwright/mcp@latest。

适合谁

  • 使用 MCP 客户端的 AI 开发者
  • 需要让 AI 操作网页的自动化工程师
  • 编写 AI 辅助测试的 QA 人员
  • 探索浏览器智能体的研究者

不太适合

  • 只需要传统 Playwright 脚本的开发者
  • 追求极致 token 效率的高吞吐编码代理(可考虑 Playwright CLI)

成熟度

  • 活跃度2026 年 11 月仍有推送,近 4 万 star,维护活跃。
  • 文档README 覆盖主流客户端安装配置,但深入用法需参考外部文档。
  • 社区近 4 万 star、3400 多 fork,社区关注度高。
  • 上手难度一条 npx 命令即可接入,配置简单。

同类项目怎么选

  • Playwright CLI同为微软出品,以命令行加 SKILL 方式提供,更省 token,适合编码代理。
  • PuppeteerNode 浏览器自动化库,不提供 MCP 接口,需自行封装。
  • Selenium老牌浏览器自动化框架,不原生面向 LLM 与 MCP。

使用前注意

  • · 需要 Node.js 18 或更新版本。
  • · 需使用支持 MCP 的客户端,如 VS Code、Cursor、Claude Desktop 等。
  • · 采用 Apache-2.0 许可,商用需遵守许可条款。
  • · 编码代理场景下 MCP 的 token 开销可能高于 CLI 方案。

主题标签

mcpplaywright