Merajmehrabi Puppeteer MCP Server

🚀 uppeteer MCP 服務器

此 MCP 服務器藉助 Puppeteer 實現瀏覽器自動化功能，支持與新瀏覽器實例以及現有 Chrome 窗口進行交互，為網頁自動化操作提供便利。

✨ 主要特性

• 多樣化網頁操作：支持瀏覽網頁、截取屏幕截圖、點擊元素、填充表單、選擇選項、鼠標懸停在元素上以及執行 JavaScript 等操作。
• 智能 Chrome 標籤管理：
  • 可連接到活動的 Chrome 標籤。
  • 保留現有的 Chrome 實例。
  • 具備智能連接處理能力。

📦 安裝指南

文檔未提及安裝步驟，暫不提供相關內容。

💻 使用示例

標準模式

服務器默認啟動一個新的瀏覽器實例。

活動標籤模式

要連接到現有的 Chrome 窗口，可按以下步驟操作：

1. 完全關閉任何現有 Chrome 實例。
2. 啟動 Chrome 並啟用遠程調試：
   • Windows 或 Linux：chrome.exe --remote-debugging-port=9222
   • Mac：open -a /Applications/Google\ Chrome.app --args --remote-debugging-port=9222
3. 打開包含 devtoolsFrontendUrl 的新標籤頁。

📚 詳細文檔

項目結構

/
├── src/
│   ├── config/        # 配置模塊
│   ├── tools/         # 工具定義和處理程序
│   ├── browser/       # 瀏覽器連接管理
│   ├── types/         # TypeScript 類型定義
│   ├── resources/     # 資源處理程序
│   └── server.ts      # 服務器初始化
├── index.ts           # 入口點
└── README.md         # 文檔

工具列表

• puppeteer_connect_active_tab：連接到活動的 Chrome 標籤。
• puppeteer_create_new_tab：創建新的 Chrome 標籤。
• puppeteer_navigate_to_url：導航到指定 URL。
• puppeteer_close_current_tab：關閉當前標籤頁。
• puppeteer_screenshot_page：截取頁面截圖。

安全注意事項

• 僅在受信任的環境中運行服務器。
• 禁止在生產環境中明文傳輸敏感信息。
• 定期更新依賴項以防範安全漏洞。

日誌記錄

概述

服務器提供詳細的日誌記錄功能，包括操作時間戳、請求上下文信息、操作執行結果以及錯誤詳細信息。所有日誌默認存儲在 ./logs/ 目錄中，按日期分文件。

錯誤處理

支持的錯誤類型

• 連接失敗
• 元素缺失
• 無效選擇器
• JavaScript 執行錯誤
• 截取截圖失敗

每個工具調用返回成功/失敗狀態、失敗時的詳細錯誤信息以及成功操作的結果數據。所有錯誤都會記錄到日誌文件中，包括時間戳、錯誤消息、堆棧跟蹤（如果有）以及上下文信息。

貢獻指南

歡迎貢獻！請查閱我們的 CONTRIBUTING.md 瞭解如何提交拉取請求、報告問題以及為項目做出貢獻。

📄 許可證

本項目使用 MIT 許可證，具體內容見 LICENSE 文件。