playwright-mcp

让 AI 直接操作浏览器,点按填表一步到位

开源 🏷️完全免费 🔧 仅开源项目,无在线服务,需自行部署 自动化工作流 🍴 复刻 3452 👀 关注 150
GitHub ↗
GitHub 星标 ★ 39850
维护状态 活跃
是否开源 开源
定价模式 🏷️完全免费 开源免费,Apache-2.0 许可证

项目预览

playwright-mcp 项目界面预览图
图片来源:GitHub 官方仓库名片

项目数据

分类自动化工作流
开发团队microsoft
定价模式🏷️完全免费
价格说明开源免费,Apache-2.0 许可证
访问状态🔧 仅开源项目,无在线服务,需自行部署
是否开源是
开源协议Apache-2.0
主要语言TypeScript
技术栈/模型mcp,playwright
GitHub 星标★ 39850
上线时间2025-03-21 00:00:00
代码更新2026-11-18
仓库体积2.0 MB
本站数据更新2026-11-19
维护状态活跃
收录时间2026-11-19
浏览次数0

项目介绍

Playwright MCP server 是一个基于 TypeScript 的模型上下文协议(MCP)服务,把 Playwright 的浏览器自动化能力封装成 AI 助手可直接调用的工具集。它解决的是大模型只能生成文本、无法真正操作网页的问题:通过 MCP 标准接口,AI 客户端可以发起打开页面、点击元素、填写表单、截图、读取页面结构等动作,让智能体完成端到端网页任务。核心能力包括基于可访问性树的页面快照与元素定位、多浏览器驱动、导航与交互操作、截图与内容提取,以及会话状态管理。相比让模型直接生成选择器脚本,它把浏览器操作抽象为结构化工具调用,降低出错率,也便于在 Claude Desktop、各类 MCP 客户端和自建 Agent 中复用,适合做网页测试辅助、信息采集流程和自动化工作流编排。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整

数据来源:GitHub API 逐日快照 · 收录于 2026-11-19 · 当前星标 ★ 39850

技术标签

使用教程

ℹ 本教程由 AI 依据该项目 README 整理,个别步骤可能需要按你的环境微调。

难度:入门 约 10 分钟 部署方式:命令行工具 7 步

环境要求

  • 已安装 Node.js 与 npm(npx 依赖 Node 环境)
  • 一个支持 MCP 的客户端(如 Claude Code、Claude Desktop、VS Code、Cursor、Cline 等)
  • 能执行 npx 命令的终端环境

安装与启动步骤

  1. 1确认 Node 环境

    MCP 服务通过 npx 启动,先确认本机已具备 Node.js 与 npm,否则后续命令会失败。

    node -v
    npm -v
  2. 2选择你的客户端

    README 按客户端分别给出安装方式,先在下面的列表中确认自己用的是哪一个,再选对应写法。

  3. 3写入标准配置

    多数客户端通用的做法:在 MCP 配置文件中加入 mcpServers 段,command 为 npx,args 指向 @playwright/mcp@latest。

    {
      "mcpServers": {
        "playwright": {
          "command": "npx",
          "args": [
            "@playwright/mcp@latest"
          ]
        }
      }
    }
  4. 4或用 CLI 一条命令加

    如果你的客户端提供命令行入口,可直接用一条命令注册,无需手写配置。

    claude mcp add playwright npx @playwright/mcp@latest
  5. 5Codex 注册方式

    Codex 用户可用 CLI 注册,也可以直接编辑 ~/.codex/config.toml 写入 mcp_servers 段。

    codex mcp add playwright npx "@playwright/mcp@latest"
  6. 6重启客户端

    保存配置后完全退出并重新打开客户端,让它重新读取 MCP 配置文件并拉起服务。

  7. 7确认工具已加载

    在客户端的 MCP 或工具面板中查看是否出现 playwright 服务及其浏览器操作工具。

关键配置

配置项必填说明示例
mcpServers.playwright.command是启动 MCP 服务的可执行程序,标准配置中固定为 npxnpx
mcpServers.playwright.args是传给命令的参数,指定运行 @playwright/mcp 最新版["@playwright/mcp@latest"]
mcpServers.playwright.type否连接类型,Cline 等客户端要求显式写 stdio,Copilot 写 localstdio
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···

★ 154 2026-08-10
agbrowse 开源

让 AI 用 JS 直接操控浏览器,省下大笔 token

Ultimate browser automation toolkit for AI agents. Zero MCP token tax, JS evaluate, ···

★ 237 2026-09-18
roamgate 开源

手机随时连终端,盯 AI 代理干活、审代码 diff

A Herdr client for any screen. Control terminals, monitor coding agents, and review ···

★ 327 2026-10-18
pi-warden 开源

给 Pi 代理加护栏,写文件守规则,假完成和死循环当场抓出

Guardrails for Pi that steer instead of interrupt: enforces your project rules on ev···

★ 194 2026-09-26
Better-HSR-Currency-Wars 开源

OCR自动刷货币战争开局与组合,解放双手

做了个专门刷货币战争的工具,可以自定义刷开局,用的是OCR识别,也可以刷游戏内一些组合,···

★ 162 2026-09-29
apitap 开源

把任意网站变成 API,不用写爬虫,不用看文档

CLI, MCP server, and npm library that turns any website into an API — no docs, no S···

★ 132 2026-08-09
mobilewright 开源

一套 API 搞定 iOS/Android 真机与模拟器自动化测试

Mobilewright is a dev framework for Mobile App Testing and Automation. It allows tes···

★ 479 2026-08-09
JamAIBase 开源

像用 Excel 一样开发 AI 应用,实时调提示词、比模型、看效果

The collaborative spreadsheet for AI. Chain cells into powerful pipelines, experimen···

★ 1104 2026-08-09
agentic-qe 开源

让 AI 智能体替你跑测试,SDLC 全阶段质量保障。

Agentic QE Fleet is an open-source AI-powered QA/QE platform designed for use with C···

★ 532 2026-10-13