Puppeteer Extra Stealth

🚀 Puppeteer-Extra MCP 服務器

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

✨ 主要特性

• 藉助 Puppeteer-Extra 實現增強型瀏覽器自動化。
• 通過 Stealth 模式避免被機器人檢測。
• 提供頁面和元素的截圖功能。
• 支持瀏覽器控制檯日誌記錄與 JavaScript 執行。
• 具備全方位交互方法，如點擊、填充、選擇、懸停等。

📦 安裝指南

克隆倉庫並安裝依賴

# 克隆倉庫
git clone <倉庫地址>
cd puppeteer_extra

# 安裝依賴項
npm install

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

Docker 鏡像構建

docker build -t mcp/puppeteer-extra .

💻 使用示例

本地運行

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

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

Docker 運行

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

構建項目

npm run build

📚 詳細文檔

工具

資源

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

1. 控制檯日誌 (console://logs)：瀏覽器控制檯輸出的文本信息，包括所有來自瀏覽器的控制檯消息。
2. 截圖 (screenshot://<名稱>)：頁面或元素的 PNG 格式截圖圖像，可通過截圖時指定的名稱訪問。

配置（適用於 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", "MCP_puppeteer_extra"]
    }
  }
}

📄 許可證

此 MCP 服務器採用 MIT License 開源協議進行許可。