MCP Puppeteer Extra

🚀 Puppeteer-Extra MCP 服務器

Puppeteer-Extra MCP 服務器是一個藉助 Puppeteer-Extra 和 Stealth 插件，增強瀏覽器自動化能力的模型上下文協議（Model Context Protocol）服務器。該服務器能讓大型語言模型以更接近人類的操作方式與網頁交互，有效避免被識別為自動化操作。

🚀 快速開始

Puppeteer-Extra MCP 服務器利用 Puppeteer-Extra 和 Stealth 插件，為大型語言模型提供了更強大的瀏覽器自動化交互能力。以下是啟動服務器的基本步驟，你可以根據自己的需求選擇合適的方式運行。

✨ 主要特性

• 增強型瀏覽器自動化功能：大幅提升瀏覽器自動化操作的能力。
• Stealth 模式防檢測：通過 Stealth 模式，有效避免被反爬蟲機制識別。
• 截圖功能：支持對頁面或元素進行截圖。
• 控制檯日誌與 JS 執行：可記錄瀏覽器控制檯日誌，並執行 JavaScript 代碼。
• 全套互動方法：提供點擊、填寫、選擇、懸停等多種交互操作。

📦 安裝指南

克隆倉庫並安裝依賴

# 克隆倉庫
git clone <repository-url>
cd puppeteer_extra

# 安裝依賴項
npm install

# 複製環境文件
cp .env.example .env.development

本地運行

# 開發模式（非無頭瀏覽器）
npm run dev

# 生產模式（無頭瀏覽器）
npm run prod

構建項目

npm run build

Docker 部署

構建 Docker 鏡像

docker build -t mcp/puppeteer-extra .

使用 Docker 運行

docker run -i --rm --init -e DOCKER_CONTAINER=true mcp/puppeteer-extra

💻 使用示例

工具使用

puppeteer_navigate

# 導航到任意URL
puppeteer_navigate('https://example.com')

此工具用於導航到指定的 URL，輸入參數為要訪問的 URL 字符串。

puppeteer_screenshot

# 截取頁面或元素的屏幕截圖
puppeteer_screenshot({
  "name": "example_screenshot",
  "selector": ".example-class",
  "width": 800,
  "height": 600
})

該工具用於截取頁面或元素的屏幕截圖，需要提供截圖名稱，可選擇指定元素選擇器、截圖寬度和高度。

puppeteer_click

# 點擊頁面上的元素
puppeteer_click('.example-button')

此工具用於點擊頁面上指定選擇器的元素。

puppeteer_hover

# 懸停在頁面上的元素上
puppeteer_hover('.example-element')

該工具用於將鼠標懸停在頁面上指定選擇器的元素上。

puppeteer_fill

# 填寫輸入字段
puppeteer_fill({
  "selector": ".example-input",
  "value": "example text"
})

該工具用於在指定選擇器的輸入字段中填寫內容。

puppeteer_select

# 在SELECT標籤中選擇元素
puppeteer_select({
  "selector": ".example-select",
  "value": "option1"
})

此工具用於在 SELECT 標籤中選擇指定的值。

puppeteer_evaluate

# 在瀏覽器控制檯執行JavaScript代碼
puppeteer_evaluate('console.log("Hello, World!")')

該工具用於在瀏覽器控制檯執行 JavaScript 代碼。

資源訪問

控制檯日誌

服務器提供了對控制檯日誌的訪問，可通過 console://logs 獲取瀏覽器控制檯輸出的文本格式信息，其中包含所有瀏覽器控制檯消息。

截圖

可通過 screenshot://<name> 訪問捕獲的頁面元素的 PNG 圖像，其中 <name> 為指定的截圖名稱。

📚 詳細文檔

配置（適用於 Claude Desktop）

Docker 配置

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

NPX 配置

{
  "mcpServers": {
    "puppeteer": {
      "command": "npx",
      "args": ["-y", "MCPuppeteerExtra"]
    }
  }
}

📄 許可證

[此處應添加具體的許可證信息]