JinDaGe - Automata-Labs-team_MCP-Server-Playwright MCP Details

article

README

🚀 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 }
      }
    }
  }
}

组件

工具

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

导航 (playwright_navigate)
- 功能：跳转到指定 URL。
- 使用方法：

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

截取屏幕截图 (playwright_screenshot)
- 功能：捕获当前页面的屏幕截图。
- 使用方法：

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

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

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

输入文本 (playwright_fill)
- 功能：填充表单字段。
- 使用方法：

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

选择下拉框 (playwright_select)
- 功能：在下拉列表中选择指定值。
- 使用方法：

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

资源

控制台日志 (console://logs)
- 类型：文本文件
- 描述：访问浏览器控制台输出的日志信息。
屏幕截图 (screenshot://<n>)
- 类型：PNG 图像文件
- 描述：通过名称引用捕获的屏幕截图。

📄 许可证

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

Automata-Labs-team_MCP-Server-Playwright