Puppeteer Linux

🚀 MCP-Puppeteer-Linux

MCP-Puppeteer-Linux 是一個提供瀏覽器自動化功能的模型上下文協議（Model Context Protocol）服務器，它藉助 Puppeteer 實現相關功能，並且完全支持 Linux 顯示服務器（X11 和 Wayland）。該服務器讓大語言模型（LLM）能夠與網頁進行交互、截取屏幕截圖以及執行 JavaScript 代碼，一切都在真實的瀏覽器環境中運行。

🚀 快速開始

MCP-Puppeteer-Linux 為大語言模型提供了在真實瀏覽器環境中與網頁交互的能力。你可以通過配置相應的工具和資源，實現網頁導航、截圖、點擊等操作。以下是一個適用於 Claude 桌面的配置示例：

{
  "mcp": {
    "servers": [
      {
        "name": "puppeteer_navigate",
        "command": "cd /path/to/app && npm start"
      },
      {
        "name": "puppeteer_screenshot",
        "command": "cd /path/to/app && npm run screenshot"
      }
    ]
  }
}

✨ 主要特性

• 瀏覽器自動化功能：支持網頁導航、截圖、點擊、鼠標懸停、表單填寫等操作。
• 顯示服務器支持：全面支持 X11 和 Wayland 顯示服務器。
• 動態環境變量配置：自動檢測並配置相應的環境變量。
• 回退機制和魯棒錯誤處理：確保在各種情況下都能穩定運行。
• XWayland 兼容性：保證在 XWayland 環境下也能正常工作。

📦 安裝指南

通過 Smithery 自動安裝

# 使用以下命令自動安裝：
smithery install @PhialsBasement/mcp-puppeteer-linux

手動安裝

1. 克隆此倉庫：

   git clone https://github.com/PhialsBasement/mcp-puppeteer_linux.git
   cd mcp-puppeteer_linux
   

2. 安裝依賴項並運行：

   npm install
   node index.js
   

📚 詳細文檔

顯示服務器支持

此分支添加了對 Linux 顯示服務器的自動檢測和配置：

• 自動檢測 X11/Wayland
• 動態環境變量配置
• 支持各種桌面環境（GNOME、KDE 等）
• 回退機制和魯棒錯誤處理
• XWayland 兼容性

組件

工具

• puppeteer_navigate
  • 在瀏覽器中導航到任何 URL
  • 輸入：url (字符串)
• puppeteer_screenshot
  • 截取網頁或特定元素的屏幕截圖
  • 輸入：
    • name (字符串，必填)：屏幕截圖名稱
    • selector (字符串，可選)：CSS 選擇器用於截取元素
    • width (數字，可選，默認：800)：截圖寬度
    • height (數字，可選，默認：600)：截圖高度
• puppeteer_click
  • 點擊頁面上的元素
  • 輸入：selector (字符串)：要點擊的元素的 CSS 選擇器
• puppeteer_hover
  • 鼠標懸停在頁面上的元素上
  • 輸入：selector (字符串)：要懸停的元素的 CSS 選擇器
• puppeteer_fill
  • 填寫表單字段
  • 輸入：
    • selector (字符串)：輸入字段的 CSS 選擇器
    • value (字符串)：要填寫的值
• puppeteer_select
  • 選擇具有 SELECT 標記的元素
  • 輸入：
    • selector (字符串)：要選擇的元素的 CSS 選擇器
• puppeteer_execute_javascript
  • 在目標上下文中執行 JavaScript 表達式
  • 輸入：
    • expression (字符串)：要執行的 JavaScript 表達式

資源

• Console Log：提供控制檯日誌輸出，使用特定 URL 格式訪問。
• Screenshot：提供截屏資源，使用特定 URL 格式訪問。

顯示服務器詳細信息

Wayland 支持

• 自動檢測和配置 Wayland 環境變量。
• 支持 XWayland 兼容性。

X11 支持

• 配置 X11 環境變量以支持傳統 Linux 顯示服務器。

📄 許可證

此項目採用 MIT License，具體信息請參考 LICENSE 文件。