Steel Puppeteer

🚀 鋼傀儡服務器

鋼傀儡服務器是一個基於模型上下文協議（MCP）的服務器，藉助Puppeteer和Steel實現瀏覽器自動化功能。它能讓大型語言模型（LLM）在真實的瀏覽器環境中與網頁交互、截取屏幕截圖，還能執行JavaScript，為網頁自動化操作提供了強大支持。

🚀 快速開始

服務器配置

1. 安裝依賴項：

npm install

2. 構建項目：

npm run build

3. 啟動服務器：

npm start

4. 打開Claude Desktop並開始瀏覽！

✨ 主要特性

• 支持Puppeteer的高級瀏覽器自動化功能。
• 集成Steel協議，實現與LLM的無縫交互。
• 提供靈活的配置選項和擴展能力。
• 支持本地和雲端部署。

📦 安裝指南

環境變量

以下環境變量可用於自定義服務器行為：

• PORT：指定服務器運行的端口（默認值：3000）。
• STEEL_API_KEY：Steel服務的API密鑰。
• PUPPETEER_WS_ENDPOINT：Puppeteer WebSocket端點。

💻 使用示例

工具

puppeteer_navigate

• 功能：在瀏覽器中導航到任意URL。
• 輸入：
  • url (字符串，必填)：要導航的URL。
  • timeout (數字，可選，默認值：60000)：導航超時時間（以毫秒為單位）。
  • waitUntil (字符串，可選，默認值："domcontentloaded")：考慮導航成功的條件。選項："load"、"domcontentloaded"、"networkidle0"、"networkidle2"。

puppeteer_screenshot

• 功能：截取網頁或特定元素的屏幕截圖。
• 輸入：
  • name (字符串，必填)：屏幕截圖的名稱。
  • selector (字符串，可選)：要截取的元素的CSS選擇器。

puppeteer_click

• 功能：點擊網頁上的元素。
• 輸入：
  • selector (字符串，必填)：要點擊的元素的CSS選擇器。

puppeteer_fill

• 功能：填寫表單字段。
• 輸入：
  • selector (字符串，必填)：表單字段的CSS選擇器。
  • value (字符串，必填)：要填寫的值。

puppeteer_select

• 功能：在SELECT標籤中選擇元素。
• 輸入：
  • selector (字符串，必填)：要選擇的元素的CSS選擇器。
  • value (字符串，必填)：要選擇的值。

資源

該服務器提供以下資源以支持瀏覽器自動化操作：

• 截圖功能。
• 元素交互（點擊、填寫等）。
• 瀏覽器事件監聽與控制。

📚 詳細文檔

故障排除

• 如果遇到Puppeteer相關問題，請確保系統上安裝了必要的依賴項。請參考Puppeteer故障排除指南獲取更多信息。
• 如果使用Steel雲服務，請確保API密鑰有效且具有必要權限。
• 如果使用本地Steel實例，請確保其正在運行並可訪問指定URL（如果是自定義）或默認本地地址。

更多詳細配置選項和高級用法，請參考Steel文檔和Puppeteer API參考。