MCP Puppeteer Server

🚀 木偶師服務器

木偶師服務器是一個藉助Puppeteer實現的模型上下文協議（Model Context Protocol）服務器，它具備強大的瀏覽器自動化功能。該服務器能讓大語言模型（LLM）與網頁進行交互、截取屏幕截圖以及執行JavaScript代碼，為用戶模擬出真實的瀏覽器環境。

🚀 快速開始

以下是Claude Desktop使用Puppeteer服務器的配置示例：

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"]
    }
  }
}

✨ 主要特性

• 瀏覽器自動化操作
• 控制檯日誌監控
• 屏幕截圖功能
• JavaScript代碼執行
• 基本網頁交互（導航、點擊、表單填寫）

📦 安裝指南

使用Docker構建：

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

📚 詳細文檔

組件

工具

資源

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

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

📄 許可證

此MCP服務器根據MIT License授權。這意味著您可以在任何用途中免費使用、修改和分發軟件，但需遵守MIT License的條款和條件。有關詳細信息，請參閱項目倉庫中的LICENSE文件。