MCP Puppeteer Linux

🚀 MCP-Puppeteer-Linux

這是一個提供瀏覽器自動化功能的模型上下文協議服務器，它藉助Puppeteer實現，並且全面支持Linux顯示服務器（X11和Wayland）。該服務器讓LLM能夠與網頁進行交互、截取屏幕截圖以及執行JavaScript，所有操作均在真實的瀏覽器環境中運行。

🚀 快速開始

安裝與運行

1. 首先安裝依賴：

npm install puppeteer

2. 創建配置文件並啟動服務。

✨ 主要特性

• 瀏覽器自動化，帶Linux顯示服務器支持
• 自動檢測X11/Wayland並配置
• 控制檯日誌監控
• 屏幕截圖能力
• JavaScript執行
• 基本網頁交互（導航、點擊、填寫表單）

📦 安裝指南

安裝依賴

npm install puppeteer

配置啟動

創建配置文件並啟動服務。例如，Claude Desktop的配置如下：

{
  "mcpServers": {
    "puppeteer": {
      "command": "npx",
      "args": ["ts-node", "/path/to/your/script.ts"]
    }
  }
}

💻 使用示例

工具使用

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圖像
   • 通過截圖名稱訪問截取的屏幕

🔧 技術細節

顯示服務器支持

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

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

顯示服務器具體支持情況

• Wayland：自動檢測和使用Wayland顯示服務器。
• X11：自動檢測和使用X11顯示服務器。

通過上述設置，您可以靈活地在不同顯示環境中運行Puppeteer。