playwright-mcp

Playwright MCP

一个使用 Playwright 提供浏览器自动化能力的模型上下文协议（MCP）服务器。该服务器使 LLM 能够通过结构化的可访问性快照与网页交互，无需截图或视觉调优模型。

Playwright MCP 与 Playwright CLI 对比

此包为 Playwright 提供 MCP 接口。如果你使用的是编码代理，使用 CLI+SKILLS 可能会更有帮助。

• CLI：现代编码代理越来越倾向于使用以 SKILL 形式暴露的基于 CLI 的工作流，而不是 MCP，因为 CLI 调用的 token 效率更高：它们避免将大型工具模式和冗长的可访问性树加载到模型上下文中，使代理能够通过简洁、专用的命令进行操作。这使得 CLI + SKILLs 更适合高吞吐量的编码代理，这些代理必须在有限的上下文窗口中平衡浏览器自动化与大型代码库、测试和推理。了解更多关于 Playwright CLI with SKILLS。

• MCP：MCP 仍然适用于专门的代理循环，这些循环受益于持久状态、丰富的内省以及对页面结构的迭代推理，例如探索性自动化、自愈测试或长期运行的自主工作流，在这些场景中，保持持续的浏览器上下文比 token 成本更重要。

主要特性

• 快速且轻量。使用 Playwright 的可访问性树，而非基于像素的输入。
• 对 LLM 友好。无需视觉模型，纯粹基于结构化数据运行。
• 确定性工具应用。避免了基于截图的方法常见的歧义。

环境要求

• Node.js 18 或更高版本
• VS Code、Cursor、Windsurf、Claude Desktop、Goose、Grok、Junie 或任何其他 MCP 客户端

快速开始

首先，在你的客户端中安装 Playwright MCP 服务器。

标准配置适用于大多数工具：

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

Amp

通过 Amp VS Code 扩展设置界面或更新你的 settings.json 文件来添加：

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

Amp CLI 设置：

通过下面的 amp mcp add 命令添加：

amp mcp add playwright -- npx @playwright/mcp@latest

Antigravity

通过 Antigravity 设置或更新你的配置文件来添加：

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

Claude Code

使用 Claude Code CLI 添加 Playwright MCP 服务器：

claude mcp add playwright npx @playwright/mcp@latest

Claude Desktop

按照 MCP 安装指南，使用上面的标准配置。

Cline

按照配置 MCP 服务器一节中的说明操作。

示例：本地设置

将以下内容添加到你的 cline_mcp_settings.json 文件中：

{
  "mcpServers": {
    "playwright": {
      "type": "stdio",
      "command": "npx",
      "timeout": 30,
      "args": [
        "-y",
        "@playwright/mcp@latest"
      ],
      "disabled": false
    }
  }
}

Codex

使用 Codex CLI 添加 Playwright MCP 服务器：

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

或者，创建或编辑配置文件 ~/.codex/config.toml 并添加：

[mcp_servers.playwright]
command = "npx"
args = ["@playwright/mcp@latest"]

更多信息，请参阅 Codex MCP 文档