Automata Labs Team MCP Server Playwright

🚀 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 文件。