Repolode
microsoft

microsoft/playwright-mcp

让 LLM 客户端通过 Playwright 基于无障碍快照操控真实浏览器的 MCP 服务器。

Star
38,397
Fork
3,288
未关闭 Issue
0
最近提交
23小时前

这是什么?

Playwright MCP 是一个 Model Context Protocol 服务器,让 LLM 客户端借助 Playwright 进行浏览器自动化。它不向视觉模型发送截图,而是把页面转换为结构化的无障碍快照,模型通过快照中的元素引用或唯一选择器操作页面。

该服务器可接入 VS Code、Cursor、Windsurf、Claude Desktop、Claude Code、Codex、Copilot 等 MCP 客户端,可通过 npx 启动,也可以以 Docker 容器运行。浏览器会话支持持久化配置文件、隔离的内存上下文,或通过浏览器扩展连接到已打开的 Chrome 或 Edge。启动参数可配置浏览器类型、视口、代理、允许与屏蔽的来源、输出目录和快照格式等。

工具涵盖点击、输入、拖放、文件上传、表单填写、执行 JavaScript、读取控制台消息、模拟媒体特性以及页面内搜索。可选能力包括基于坐标的视觉交互、PDF 处理和开发者工具功能。项目同时声明它本身并非安全边界。

核心功能

  • 01基于 Playwright 无障碍快照工作,无需视觉模型即可理解页面。
  • 02兼容 VS Code、Cursor、Claude Desktop、Codex 等多种 MCP 客户端。
  • 03支持持久化配置、隔离会话,以及通过浏览器扩展连接已有浏览器。
  • 04提供点击、表单填写、文件上传、拖放和执行 JavaScript 等工具。
  • 05支持 JSON 配置文件和大量命令行参数,可调整浏览器、网络和输出设置。

适用场景

  • 让 AI 编程助手打开 Web 应用、检查页面状态并验证改动。
  • 由 LLM 驱动的探索式测试或自愈测试流程。
  • 借助持久化或已连接的浏览器配置,自动化需要登录状态的网页任务。
  • 在 Docker 容器中为智能体运行无头浏览器自动化。

快速上手

  1. 1

    将标准配置添加到你的 MCP 客户端(通过 npx 运行)

    npx @playwright/mcp@latest
  2. 2

    使用 Claude Code 安装 Playwright MCP 服务器

    claude mcp add playwright npx @playwright/mcp@latest

使用前须知

  • 需要 Node.js 18 或更高版本。
  • 需要兼容 MCP 的客户端才能使用。
  • README 指出,对于编程代理,基于 CLI 加 SKILLS 的方式可能更节省 token。

标签

常见问题

playwright-mcp 是什么?
让 LLM 客户端通过 Playwright 基于无障碍快照操控真实浏览器的 MCP 服务器。 Playwright MCP 是一个 Model Context Protocol 服务器,让 LLM 客户端借助 Playwright 进行浏览器自动化。它不向视觉模型发送截图,而是把页面转换为结构化的无障碍快照,模型通过快照中的元素引用或唯一选择器操作页面。
playwright-mcp 可以免费使用吗?用的什么许可证?
playwright-mcp 以 Apache-2.0 许可证开源。用于商业产品前,请先确认许可证条款。
playwright-mcp 还在维护吗?
活跃维护中。playwright-mcp 最近一次提交是在 2026年10月19日。
playwright-mcp 适合用来做什么?
让 AI 编程助手打开 Web 应用、检查页面状态并验证改动。 由 LLM 驱动的探索式测试或自愈测试流程。 借助持久化或已连接的浏览器配置,自动化需要登录状态的网页任务。 在 Docker 容器中为智能体运行无头浏览器自动化。
playwright-mcp 怎么安装和运行?
将标准配置添加到你的 MCP 客户端(通过 npx 运行): npx @playwright/mcp@latest 使用 Claude Code 安装 Playwright MCP 服务器: claude mcp add playwright npx @playwright/mcp@latest
在哪里获取 playwright-mcp?
源代码和安装说明在 GitHub 上:https://github.com/microsoft/playwright-mcp

概要由 AI 根据项目 README 生成;GitHub 数据每日更新。

相关项目