MCP Puppeteer

🚀 皮影戲工具集

皮影戲工具集是一個基於 Puppeteer 的 Model Context Protocol 服務器，它提供了瀏覽器自動化功能。藉助該服務器，LLM 能夠在真實的瀏覽器環境中與網頁進行交互、截取屏幕截圖，還能執行 JavaScript 代碼，為網頁自動化操作提供了便利。

✨ 主要特性

• 瀏覽器自動化：可實現網頁的自動化操作。
• 控制檯日誌監控：能監控瀏覽器控制檯輸出的日誌。
• 屏幕截圖功能：支持截取頁面或特定元素的屏幕截圖。
• JavaScript 執行：可在瀏覽器控制檯執行 JavaScript 代碼。
• 基本網頁交互：涵蓋導航、點擊、表單填充等常見網頁交互操作。

📦 安裝指南

Docker 構建

docker build -t mcp/puppeteer -f src/puppeteer/Dockerfile .

💻 使用示例

工具使用說明

puppeteer_navigate

• 功能：在瀏覽器中導航到任何 URL。
• 輸入：url（字符串）

puppeteer_screenshot

• 功能：截取頁面或特定元素的屏幕截圖。
• 輸入：
  • name（字符串，必填）：屏幕截圖的名稱。
  • selector（字符串，可選）：截取元素的 CSS 選擇器。
  • width（數字，可選，默認值：800）：屏幕截圖寬度。
  • height（數字，可選，默認值：600）：屏幕截圖高度。

puppeteer_click

• 功能：點擊頁面上的元素。
• 輸入：selector（字符串）：要點擊的元素的選擇器。

puppeteer_hover

• 功能：鼠標懸停在頁面上的元素上。
• 輸入：selector（字符串）：要懸停的元素的選擇器。

puppeteer_fill

• 功能：填充輸入字段。
• 輸入：
  • selector（字符串）：輸入字段的選擇器。
  • value（字符串）：要填充的值。

puppeteer_select

• 功能：在 SELECT 標記中選擇元素。
• 輸入：
  • selector（字符串）：要選擇的元素的選擇器。
  • value（字符串）：要選擇的值。

puppeteer_evaluate

• 功能：在瀏覽器控制檯執行 JavaScript。
• 輸入：script（字符串）：要執行的 JavaScript 代碼。

資源說明

服務器提供兩種類型的資源：

1. 控制檯日誌 (console://logs)
   • 瀏覽器控制檯輸出的文本格式，包括瀏覽器中的所有控制檯消息。
2. 屏幕截圖 (screenshot://<name>)
   • 指定名稱的 PNG 圖像屏幕截圖，可通過 screenshot 名稱訪問截取的屏幕截圖。

使用 Puppeteer Server 的配置

Docker

注意：Docker 實現將使用無頭 Chromium，而 NPX 版本將打開瀏覽器窗口。

{
  "mcpServers": {
    "puppeteer": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "--init",
        "-e",
        "DOCKER_CONTAINER=true",
        "mcp/puppeteer"
      ]
    }
  }
}

NPX

{
  "mcpServers": {
    "puppeteer": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-puppeteer"]
    }
  }
}

📄 許可證

此 MCP 服務器根據 MIT 許可證發佈。這意味著您可以自由使用、修改和分發軟件，但需遵守 MIT 許可證的條款和條件。有關更多詳細信息，請參閱項目倉庫中的 LICENSE 文件。