MCP 服务器 Playwright

一个提供浏览器自动化功能的模型上下文协议（Model Context Protocol）服务器，使用 Playwright 实现
_{启用大语言模型与网页交互、截取屏幕截图并执行浏览器环境中的 JavaScript}

MCP 服务器 Playwright 简体中文文档

目录

• 简介
• 安装
• 配置
• 组件
  • 工具
  • 资源
• 许可证

简介

这是一个基于 Playwright 的模型上下文协议（MCP）服务器，主要用于提供浏览器自动化功能。通过该服务器，可以实现大语言模型与网页的交互，包括截取屏幕截图和执行 JavaScript 操作。

安装

使用 Smithery

可以通过以下命令安装：

smith install @automatalabs/mcp-server-playwright

使用 CLI 工具

也可以通过 Node.js 包管理工具进行安装：

npm install @automatalabs/mcp-server-playwright

配置

项目的配置文件通常是一个 JSON 文件，示例如下：

{
  "serverPort": 3000,
  "playwrightConfig": {
    "devices": {
      "Desktop Chrome": {
        "browserName": "chromium",
        "isMobile": false,
        "viewport": { "width": 1920, "height": 1080 }
      }
    }
  }
}

组件

工具

以下是该服务器提供的主要工具：

1. 导航 (playwright_navigate)

   • 功能：跳转到指定 URL。
   • 使用方法：

     { "command": "playwright_navigate", "args": { "url": "https://example.com" } }
     

2. 截取屏幕截图 (playwright_screenshot)

   • 功能：捕获当前页面的屏幕截图。
   • 使用方法：

     { "command": "playwright_screenshot", "args": { "name": "screenshot-name" } }
     

3. 执行 JavaScript (playwright_evaluate)

   • 功能：在浏览器上下文中执行任意 JavaScript 代码。
   • 使用方法：

     { "command": "playwright_evaluate", "args": { "script": "document.title" } }
     

4. 输入文本 (playwright_fill)

   • 功能：填充表单字段。
   • 使用方法：

     { "command": "playwright_fill", "args": { "selector": "#input-field", "value": "Hello World" } }
     

5. 选择下拉框 (playwright_select)

   • 功能：在下拉列表中选择指定值。
   • 使用方法：

     { "command": "playwright_select", "args": { "selector": "#dropdown", "value": "option-value" } }
     

资源

1. 控制台日志 (console://logs)

   • 类型：文本文件
   • 描述：访问浏览器控制台输出的日志信息。

2. 屏幕截图 (screenshot://<n>)

   • 类型：PNG 图像文件
   • 描述：通过名称引用捕获的屏幕截图。

许可证

该项目采用 MIT 许可证，具体内容请参阅 LICENSE 文件。