返回 MCP 目录
public公开dns本地运行

Automata-Labs-team_MCP-Server-Playwright

MCP Server Playwright是一个基于Playwright的浏览器自动化服务器,为LLM提供网页交互、截图和JavaScript执行能力。

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

help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端