Rdvo MCP Server

🚀 鋼傀儡模型上下文協議服務器

鋼傀儡模型上下文協議服務器藉助Puppeteer和Steel提供的瀏覽器自動化能力，讓大語言模型（LLM）能夠與網頁交互、截取屏幕截圖以及執行JavaScript代碼，為其提供真實的瀏覽器環境。

🚀 快速開始

運行步驟

1. 安裝依賴：

   npm install
   

2. 構建項目：

   npm run build
   

3. 啟動服務器：

   npm start
   

4. 打開Claude桌面應用程序，即可開始使用！

默認情況下，服務器將在端口3000上監聽請求。

✨ 主要特性

• 支持使用Puppeteer進行瀏覽器自動化操作。
• 提供強大的控制檯功能以與網頁交互。
• 支持多種滾動行為和塊定位。
• 集成Steel協議進行模型上下文交互。
• 支持自定義用戶代理字符串。
• 提供詳細的日誌記錄和調試選項。

📦 安裝指南

環境變量

以下是運行服務器所需的關鍵環境變量：

• NODE_ENV：設置為"production"以啟用生產模式，默認值："development"。
• PORT：指定服務器監聽的端口，範圍1024到65535，默認值：3000。
• PUPPETEER_WS_ENDPOINT：指定Puppeteer WebSocket端點，默認值：ws://localhost:3000/ws/puppeteer。
• STEEL_API_KEY：Steel API密鑰，用於身份驗證。
• STEEL_SERVER_URL：Steel服務URL，默認值：http://localhost:8080。

服務器配置

要自定義服務器行為，請編輯以下配置選項：

{
  "puppeteer": {
    "defaultViewport": { // 默認視口設置
      "width": 1920,
      "height": 1080,
      "deviceScaleFactor": 1,
      "isLandscape": true,
      "hasTouch": false,
      "isMobile": false
    },
    "userAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/91.0.4472.126 Safari/537.36" // 自定義用戶代理字符串
  },
  "steel": {
    "apiEndpoint": "http://localhost:8080", // Steel API端點
    "timeout": 30000, // 請求超時時間（毫秒）
    "proxyEnabled": true, // 是否啟用代理
    "proxyUrl": "http://localhost:8081" // 代理服務器URL
  },
  "logging": {
    "enabled": true, // 啟用日誌記錄
    "level": "info", // 日誌級別："debug"、"info"、"warn"、"error"
    "outputFile": "./logs/server.log" // 日誌輸出文件路徑
  }
}

📚 詳細文檔

組件

工具

資源

🔧 技術細節

故障排除

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

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