使用说明

项目简介

mcp-playwright 是一个基于 Model Context Protocol (MCP) 构建的服务器，它扩展了大型语言模型（LLM）的能力，使其能够通过 Playwright 这一强大的自动化工具与网页进行交互，并执行 API 请求。此服务器允许 LLM 控制浏览器行为，例如导航、点击、填写表单、截取网页内容，并能执行 GET、POST 等多种 HTTP 请求，从而实现更丰富的应用场景，例如网页信息抓取、自动化测试、以及更复杂的网络任务。

主要功能点

网页自动化: 支持 LLM 控制浏览器进行各种操作，包括：
- 导航到指定 URL
- 截取网页或特定元素的屏幕截图
- 模拟用户点击和悬停操作
- 填写网页表单和选择下拉选项
- 在浏览器环境中执行 JavaScript 代码
API 请求: 允许 LLM 发起各种 HTTP 请求，包括 GET, POST, PUT, PATCH, DELETE，并获取 API 响应。
资源管理: 提供浏览器控制台日志和屏幕截图作为资源，LLM 可以按需访问这些信息。
工具集成: 预置了一系列基于 Playwright 的工具，方便 LLM 调用执行网页和 API 相关的任务。

安装步骤

可以通过 npm, mcp-get 或 Smithery 等多种方式安装 mcp-playwright 服务器：

使用 npm 安装:

npm install -g @executeautomation/playwright-mcp-server

使用 mcp-get 安装:

npx @michaellatman/mcp-get@latest install @executeautomation/playwright-mcp-server

使用 Smithery 安装:

npx @smithery/cli install @executeautomation/playwright-mcp-server --client claude

服务器配置

要将 mcp-playwright 服务器与 MCP 客户端（例如 Claude Desktop）连接，您需要在客户端中配置服务器的启动命令。以下是 Claude Desktop 的配置示例：

{
  "mcpServers": {
    "playwright": { #  服务器名称，可以自定义
      "command": "npx", #  启动命令，通常为 npx 或 node
      "args": ["-y", "@executeautomation/playwright-mcp-server"] #  命令参数，指定要执行的 npm 包
    }
  }
}

配置参数说明:

'mcpServers': 定义 MCP 服务器的配置。
'playwright': 自定义的服务器名称，用于在客户端中标识该服务器。
'command': 启动服务器的命令，通常是 'npx'（用于执行 npm 包）或 'node'（如果直接运行 JavaScript 文件）。
'args': 传递给启动命令的参数，这里 '-y' 用于 npm 的非交互式安装，'@executeautomation/playwright-mcp-server' 是要执行的 npm 包名，即 mcp-playwright 服务器。

基本使用方法

安装并配置服务器后，MCP 客户端（如 Claude）可以通过 MCP 协议与 mcp-playwright 服务器进行通信。客户端可以调用服务器提供的工具来执行浏览器自动化和 API 请求任务。

例如，LLM 客户端可以调用 'playwright_navigate' 工具来让浏览器访问特定网页，或调用 'playwright_screenshot' 工具来截取当前网页的屏幕截图。具体的工具调用方式和参数需要参考 MCP 客户端的文档和 mcp-playwright 服务器提供的工具定义。

注意: mcp-playwright 服务器需要 Node.js 环境运行。请确保您的运行环境中已安装 Node.js。

关键词