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