MCP

Playwright MCP:在客户端里完成第一次浏览器导航

适合要在 MCP 客户端里用无障碍快照驱动浏览器访问指定页面的人,前提是本机已安装 Node.js 18 或更新。

官方来源 · Playwright MCP

安装

npx @playwright/mcp@latest

适合谁

这份指南面向已经在使用 MCP 客户端、并准备在本机拉起浏览器来完成页面自动化的人。你要判断的是应不应该现在就把 Playwright MCP 接到当前客户端,而不是先把它当成长篇介绍来读。最硬的前提是本机 Node.js 为 18 或更新;版本不够就不要继续写配置。仓库说明它是一个提供浏览器自动化能力的 MCP 服务器,并且走无障碍快照,而不是靠截图理解页面。你必须能接受两件事:本机会出现浏览器相关进程,以及会对你指定的地址发起真实访问。如果你只想浏览仓库、不打算让客户端执行任何浏览器动作,这条路径不适合。证据没有写适用行业、岗位或团队规模,这里也不补充想象中的用户画像。

3 分钟完成第一次尝试

只使用官方标准 MCP 配置这一条路径。打开你当前正在用的 MCP 客户端自己的服务器配置位置——证据没有给出具体文件名,所以按该客户端的 MCP 设置入口打开即可——新增名为 playwright 的服务,命令为 npx,参数为 @playwright/mcp@latest。不要再并列第二条主安装方式。

先确认本机已满足 Node.js 18 或更新,再把下面这段 JSON 原样写入配置,保持字节一致,不要改键名、不要改空格:

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

保存后重启或重载该客户端。成功信号是工具列表里出现 browser_navigate 和 browser_navigate_back 这两个名字;名字暴露出来才算接通,不要把浏览器窗口是否弹出、页面是否打开当成安装完成。

接通之后只做一次试探性调用:使用 browser_navigate。证据只记录了工具名,没有参数表、没有示例网址、也没有撤销路径,因此填写内容只能以客户端当时展示的工具说明为准,不要自行发明参数或端点。这次调用会让本机浏览器访问你给出的地址,产生网络请求和页面加载,并在本机留下浏览器相关进程;它不是只读操作,也不是零风险。调用前必须确认地址由你本人指定、且该地址可以接受被访问;调用后以这次调用是否返回作为确认点。如果接着使用 browser_navigate_back,同样会改变浏览器当前页,同样可能再次产生网络请求,调用前先确认当前会话里已经有可以回退的浏览记录。

使用案例

案例一:用 browser_navigate 打开一个你明确指定的页面。时机是两个工具名已经出现,并且你手里有一个可以接受被访问的地址。证据能够映射到的只有这个工具名,没有示范 URL,也没有写出参数字段。副作用是真实导航和网络访问;调用前再次核对地址,调用后看这次调用是否结束。不要把它理解成本地离线预览,也不要假设不会读取页面内容。

案例二:用 browser_navigate_back 回到上一页。时机是同一次浏览会话里刚刚完成过导航。证据同样只给出这个工具名,没有历史列表接口,也没有撤销或 undo 路径。如果还没有成功的前向导航,回退可能失败,或落到你并不预期的页面,证据没有描述失败后的状态。该调用同样会改变当前页,并可能再次请求网络;调用前确认你确实已经导航过,确认点仍然是这次调用是否返回。

使用边界

运行下限是 Node.js 18 或更新,低版本不要硬跑。能力停在浏览器自动化,并且说明使用无障碍快照而不是截图;证据没有出现截图类工具,也没有关闭浏览器、清理会话、卸载或 undo 命令。不要假设无网络、无本机读取或没有隐私边界:一旦导航,目标站会被访问,页面内容可能进入客户端上下文,本机也会出现浏览器进程。第一次尝试失败时,先核对 Node 版本以及 JSON 是否与官方片段字节一致,再看两个工具名有没有出现;不要改用证据中没有出现的安装方式。未在证据里点名的能力不要当已支持。