项目简介

Playwright MCP Server 是一个基于 Model Context Protocol (MCP) 的服务器实现，旨在将功能强大的 Playwright Web 测试自动化工具的能力暴露给大型语言模型 (LLM) 客户端。通过此服务器，LLM 客户端可以理解 Playwright 的上下文、访问测试资源，并调用 Playwright 的功能来执行或分析测试任务，从而实现更智能、更上下文感知的测试自动化。

主要功能点

• Playwright 能力集成: 将 Playwright 的浏览器交互、元素定位、断言等能力抽象化，供 LLM 客户端调用。
• 测试上下文提供: LLM 可以通过服务器获取当前测试项目的结构、测试文件内容、页面对象模型等信息。
• AI 驱动测试: 使 LLM 能够协助编写、执行、调试和分析 Playwright 测试。
• 标准协议通信: 使用 MCP 定义的 JSON-RPC 协议与兼容的 LLM 客户端通信。

安装步骤

在开始之前，请确保您的系统已安装 Node.js v20 或更高版本。

1. 克隆或下载包含 Playwright MCP Server 的项目代码。
2. 在项目根目录下打开终端。
3. 安装项目依赖，包括 Playwright 和 dotenv：

   npm install
   npm install dotenv
   

4. 安装 Playwright 浏览器二进制文件：

   npx playwright install
   

5. （可选）如果您使用 VS Code，可以安装 Playwright 扩展以获得更好的开发体验：

   code --install-extension ms-playwright.playwright
   

服务器配置

Playwright MCP Server 启动后会监听来自 MCP 客户端（如 Cursor）的连接。为了让您的 MCP 客户端能够连接并使用此服务器，您需要在客户端的 MCP 服务器配置中指定如何启动此服务器。

客户端通常需要配置以下信息：

• 服务器名称: 一个易于识别的名称，例如 "Playwright MCP Server"。
• 启动命令: 执行服务器的可执行文件路径，对于 Node.js 项目通常是 'npx'。
• 启动参数: 传递给启动命令的参数，用于指定运行哪个 MCP 服务器包。根据仓库信息，参数应为 'playwright-mcp'。

例如，在支持 MCP 的 LLM 客户端中，您需要配置一个条目，其启动命令指向 'npx'，参数包含 'playwright-mcp'。客户端会根据这个配置在需要时启动服务器并通过标准输入/输出进行通信。

基本使用方法

1. 打开一个终端窗口。
2. 在项目根目录下，使用以下命令启动 Playwright MCP Server：

   npx playwright-mcp
   

   服务器将在终端中启动并等待 MCP 客户端连接。
3. 启动您的 MCP 客户端（如 Cursor），并确保其配置了连接 Playwright MCP Server 的信息。
4. 在 MCP 客户端中，您现在应该能够看到并使用 Playwright MCP Server 提供的功能，例如在与 LLM 交互时，LLM 可以调用服务器的能力来执行 Playwright 相关的任务或获取测试项目的上下文。

请注意，每个终端会话通常只能运行一个 MCP 服务器。如果您需要同时使用其他 MCP 服务器（如 Context7），请在不同的终端窗口中启动它们。