Scrapybara (Virtual Ubuntu)

🚀 Scrapybara MCP

Scrapybara模型上下文協議（MCP）服務器，可讓Claude Desktop、Cursor和Windsurf等MCP客戶端與虛擬Ubuntu桌面交互，實現網頁瀏覽、代碼運行等操作。

🚀 快速開始

在使用Scrapybara MCP之前，需要滿足以下先決條件，並完成安裝配置。

✨ 主要特性

• 支持MCP客戶端與虛擬Ubuntu桌面交互。
• 提供多種工具，可對Scrapybara實例進行啟動、停止、執行命令等操作。

📦 安裝指南

先決條件

• Node.js 18+版本
• pnpm
• Scrapybara API密鑰（可在scrapybara.com獲取）

安裝步驟

1. 克隆倉庫：

git clone https://github.com/scrapybara/scrapybara-mcp.git
cd scrapybara-mcp

2. 安裝依賴項：

pnpm install

3. 構建項目：

pnpm build

4. 將以下內容添加到您的MCP客戶端配置中：

{
  "mcpServers": {
    "scrapybara-mcp": {
      "command": "node",
      "args": ["path/to/scrapybara-mcp/dist/index.js"],
      "env": {
        "SCRAPYBARA_API_KEY": "<YOUR_SCRAPYBARA_API_KEY>",
        "ACT_MODEL": "<YOUR_ACT_MODEL>", // "anthropic" 或 "openai"
        "AUTH_STATE_ID": "<YOUR_AUTH_STATE_ID>" // 可選，用於瀏覽器的身份驗證
      }
    }
  }
}

5. 重啟您的MCP客戶端，完成配置！

📚 詳細文檔

工具說明

• start_instance - 啟動一個Scrapybara Ubuntu實例，作為桌面沙盒用於訪問網頁或運行代碼，並向用戶呈現流URL以即時觀看實例。
• get_instances - 獲取所有正在運行的Scrapybara實例。
• stop_instance - 停止正在運行的Scrapybara實例。
• bash - 在Scrapybara實例中執行bash命令。
• act - 通過代理對Scrapybara實例採取行動，代理可通過鼠標/鍵盤和bash命令控制實例。

🤝 貢獻說明

Scrapybara MCP是一個社區驅動的項目，歡迎大家貢獻想法、修復拼寫錯誤、添加新工具或改進現有功能。在貢獻之前，請閱讀現有的問題和Pull Request，避免重複勞動。如果您希望添加更多工具或功能，可在問題頁面提出建議。