
playwright-mcp
让 AI 直接操作浏览器,点按填表一步到位
项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-11-19 · 当前星标 ★ 39850
技术标签
使用教程
ℹ 本教程由 AI 依据该项目 README 整理,个别步骤可能需要按你的环境微调。
环境要求
- 已安装 Node.js 与 npm(npx 依赖 Node 环境)
- 一个支持 MCP 的客户端(如 Claude Code、Claude Desktop、VS Code、Cursor、Cline 等)
- 能执行 npx 命令的终端环境
安装与启动步骤
-
1确认 Node 环境
MCP 服务通过 npx 启动,先确认本机已具备 Node.js 与 npm,否则后续命令会失败。
node -v npm -v -
2选择你的客户端
README 按客户端分别给出安装方式,先在下面的列表中确认自己用的是哪一个,再选对应写法。
-
3写入标准配置
多数客户端通用的做法:在 MCP 配置文件中加入 mcpServers 段,command 为 npx,args 指向 @playwright/mcp@latest。
{ "mcpServers": { "playwright": { "command": "npx", "args": [ "@playwright/mcp@latest" ] } } } -
4或用 CLI 一条命令加
如果你的客户端提供命令行入口,可直接用一条命令注册,无需手写配置。
claude mcp add playwright npx @playwright/mcp@latest -
5Codex 注册方式
Codex 用户可用 CLI 注册,也可以直接编辑 ~/.codex/config.toml 写入 mcp_servers 段。
codex mcp add playwright npx "@playwright/mcp@latest" -
6重启客户端
保存配置后完全退出并重新打开客户端,让它重新读取 MCP 配置文件并拉起服务。
-
7确认工具已加载
在客户端的 MCP 或工具面板中查看是否出现 playwright 服务及其浏览器操作工具。
关键配置
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
mcpServers.playwright.command | 是 | 启动 MCP 服务的可执行程序,标准配置中固定为 npx | npx |
mcpServers.playwright.args | 是 | 传给命令的参数,指定运行 @playwright/mcp 最新版 | ["@playwright/mcp@latest"] |
mcpServers.playwright.type | 否 | 连接类型,Cline 等客户端要求显式写 stdio,Copilot 写 local | stdio |
mcpServers.playwright.timeout | 否 | 客户端等待服务响应的超时秒数,Cline 示例中给出 | 30 |
mcpServers.playwright.disabled | 否 | 是否禁用该服务,保持 false 表示启用 | false |
如何确认成功
重启客户端后,在 MCP 服务器或工具列表中能看到 playwright 服务及其浏览器操作工具,即表示启动成功。
常见问题
Q:配置写好了但客户端里看不到工具?
A:先确认配置文件位置与格式正确(JSON 不能有注释和多余逗号),再完全退出并重启客户端;Cline 等客户端还需把 timeout 设为 30 左右,避免首次下载超时。
Q:npx 报错找不到命令怎么办?
A:说明本机没有可用的 Node.js/npm 环境,先安装 Node.js 后重开终端,再执行 npx @playwright/mcp@latest 验证。
Q:编码代理适合用这个吗?
A:README 指出编码代理更适合 CLI + SKILLS 方式(见 microsoft/playwright-cli),因为 MCP 会把较大的工具描述和页面结构放进上下文;MCP 更适合需要持续浏览器状态与反复推理的场景。
Q:必须写 @latest 吗?
A:README 的示例全部使用 @playwright/mcp@latest,写 latest 可自动获取最新版本;若需固定版本,可把标签换成具体版本号。
注意事项
- README 未给出独立的安装命令,服务由客户端通过 npx 自动拉起,无需手工全局安装。
- 不同客户端的配置文件路径不同(如 ~/.codex/config.toml、~/.grok/config.toml、~/.copilot/mcp-config.json、.junie/mcp/mcp.json 等),按所用客户端选择。
- 首次运行时 npx 需要下载依赖包,启动会比之后慢一些。
- 多个客户端不建议同时配置同一服务实例,避免相互干扰。
核心亮点
- 基于可访问性树生成页面快照,元素定位比裸选择器更稳定
- 以 MCP 标准工具形式暴露浏览器能力,可接入多种 AI 客户端
- 由 Playwright 官方团队维护,浏览器兼容性和更新节奏有保障
不足之处
- 依赖 MCP 客户端生态,非 MCP 环境接入成本较高
- 复杂动态页面仍需人工设计操作步骤,全自动推理能力有限
- 高频快照与截图会产生较大上下文开销
适用场景
- AI 助手代用户完成网页表单填写与提交
- 自动化网页测试中的操作步骤生成与回放
- 信息采集流程中的页面导航与内容提取
替代项目
browser-use、Puppeteer、Selenium
上一篇:mcp
下一篇:Windows-MCP
同类项目推荐
pbottleRPA
开源
用脚本+AI 搞定浏览器和桌面重复操作
pbottleRPA is a professional RPA+AI software for professional users. It supports pr···
agbrowse
开源
让 AI 用 JS 直接操控浏览器,省下大笔 token
Ultimate browser automation toolkit for AI agents. Zero MCP token tax, JS evaluate, ···
roamgate
开源
手机随时连终端,盯 AI 代理干活、审代码 diff
A Herdr client for any screen. Control terminals, monitor coding agents, and review ···
pi-warden
开源
给 Pi 代理加护栏,写文件守规则,假完成和死循环当场抓出
Guardrails for Pi that steer instead of interrupt: enforces your project rules on ev···
Better-HSR-Currency-Wars
开源
OCR自动刷货币战争开局与组合,解放双手
做了个专门刷货币战争的工具,可以自定义刷开局,用的是OCR识别,也可以刷游戏内一些组合,···
apitap
开源
把任意网站变成 API,不用写爬虫,不用看文档
CLI, MCP server, and npm library that turns any website into an API — no docs, no S···
mobilewright
开源
一套 API 搞定 iOS/Android 真机与模拟器自动化测试
Mobilewright is a dev framework for Mobile App Testing and Automation. It allows tes···
JamAIBase
开源
像用 Excel 一样开发 AI 应用,实时调提示词、比模型、看效果
The collaborative spreadsheet for AI. Chain cells into powerful pipelines, experimen···
agentic-qe
开源
让 AI 智能体替你跑测试,SDLC 全阶段质量保障。
Agentic QE Fleet is an open-source AI-powered QA/QE platform designed for use with C···