MCP Server Playwright Hdj

🚀 MCP 服務器 Playwright

MCP 服務器 Playwright 提供全瀏覽器自動化能力，支持頁面截圖捕獲、網頁交互、控制檯日誌監控等功能，可助力開發者高效完成自動化測試等任務。

🚀 快速開始

本項目可通過多種方式安裝，安裝後會自動配置相關文件，之後就能使用其提供的各類工具進行瀏覽器自動化操作。

✨ 主要特性

• 🌐 全瀏覽器自動化能力
• 📸 頁面或特定元素的截圖捕獲
• 🖱️ 全面的網頁交互（導航、點擊、表單填寫）
• 📊 控制檯日誌監控
• 🔧 瀏覽器上下文中的 JavaScript 執行

📦 安裝指南

通過 Smithery 安裝

通過 Smithery 自動為 Claude 桌面安裝 MCP Server Playwright：

npx -y @smithery/cli install @automatalabs/mcp-server-playwright --client claude

您可以通過 npx 或 mcp-get 進行安裝：

使用 npx

npx @automatalabs/mcp-server-playwright install

此命令將：

• 檢查您的操作系統兼容性（Windows/macOS）
• 創建或更新 Claude 配置文件
• 配置 Playwright 服務器集成

配置文件將自動創建/更新為：

• Windows：%APPDATA%\Claude\claude_desktop_config.json
• macOS：~/Library/Application Support/Claude/claude_desktop_config.json

使用 mcp-get

npx @michaellatman/mcp-get@latest install @automatalabs/mcp-server-playwright

📚 詳細文檔

配置

安裝過程會自動將以下配置添加到您的 Claude 配置文件中：

{
  "mcpServers": {
    "playwright": {
      "command": "npx",
      "args": ["-y", "@automatalabs/mcp-server-playwright"]
    }
  }
}

工具

browser_navigate

導航到任意 URL

{
  "url": "https://stealthbrowser.cloud"
}

browser_screenshot

捕獲頁面或特定元素的截圖

{
  "name": "screenshot-name",     // 必填
  "selector": "#element-id",     // 可選
  "fullPage": true              // 可選，默認：false
}

browser_click

使用 CSS 選擇器點擊頁面上的元素

{
  "selector": "#button-id"
}

browser_click_text

通過文本內容點擊頁面上的元素

{
  "text": "Click me"
}

browser_hover

懸停在頁面上的元素上（使用 CSS 選擇器）

{
  "selector": "#menu-item"
}

browser_hover_text

通過文本內容懸停在頁面上的元素上

{
  "text": "Hover me"
}

browser_fill

填寫表單字段

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

browser_select

在 SELECT 元素中選擇選項（使用 CSS 選擇器）

{
  "selector": "#dropdown",
  "value": "option-value"
}

browser_select_text

通過文本內容在 SELECT 元素中選擇選項

{
  "text": "Choose me",
  "value": "option-value"
}

browser_evaluate

在瀏覽器控制檯中執行 JavaScript

{
  "script": "document.title"
}

資源

控制檯日誌（console://logs）

• 以文本格式訪問瀏覽器控制檯輸出
• 包括來自瀏覽器的所有控制檯消息

屏幕截圖（screenshot://）

• 訪問 PNG 格式的捕獲截圖
• 通過捕獲時指定的名稱引用

📄 許可證

文檔中未提及具體許可證信息，若有相關信息可補充至此。