Puppeteer

🚀 木偶師服務器

木偶師服務器是一個基於Puppeteer的模型上下文協議（MCP）服務器，它能夠提供強大的瀏覽器自動化功能。藉助該服務器，大語言模型（LLMs）可以與網頁進行交互、截取屏幕截圖，還能在真實的瀏覽器環境中執行JavaScript代碼。

🚀 快速開始

本部分將為你介紹木偶師服務器的核心功能、使用配置、構建方法等內容，助你快速上手。

✨ 主要特性

• 瀏覽器自動化：實現瀏覽器的自動化操作，提高工作效率。
• 控制檯日誌監控：即時監控瀏覽器控制檯輸出的文本信息。
• 屏幕截圖功能：支持截取網頁或特定元素的屏幕截圖。
• JavaScript執行能力：可在瀏覽器控制檯執行JavaScript代碼。
• 基本網頁交互：提供導航、點擊、表單填寫等基本網頁交互功能。

📦 安裝指南

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

構建

Docker構建：

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

💻 使用示例

工具

資源

服務器提供以下兩種資源：

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

📚 詳細文檔

核心功能

• 瀏覽器自動化：通過各種工具實現瀏覽器的自動化操作。
• 控制檯日誌監控：可通過訪問console://logs獲取瀏覽器控制檯輸出的文本信息。
• 屏幕截圖功能：使用puppeteer_screenshot工具截取屏幕截圖，並通過screenshot://<name>訪問。
• JavaScript執行能力：使用puppeteer_evaluate工具在瀏覽器控制檯執行JavaScript代碼。
• 基本網頁交互：提供導航、點擊、表單填寫等基本網頁交互功能，可通過相應工具實現。

📄 許可證

該MCP服務器根據MIT License授權。這意味著您可以在不受限制的情況下使用、修改和分發軟件，但需遵守MIT License的條款和條件。如需更多信息，請參閱項目倉庫中的LICENSE文件。