JinDaGe - Scrapybara (Virtual Ubuntu) MCP Details

article

README

🚀 Scrapybara MCP

Scrapybara MCP是Scrapybara模型上下文协议（MCP）服务器。它能让Claude Desktop、Cursor和Windsurf等MCP客户端与虚拟Ubuntu桌面进行交互，实现浏览网页、运行代码等操作。

🚀 快速开始

Scrapybara MCP服务器允许特定的MCP客户端与虚拟Ubuntu桌面交互。在使用前，请确保满足以下先决条件，并按照安装步骤进行操作。

✨ 主要特性

支持多种MCP客户端，如Claude Desktop、Cursor和Windsurf。
可让客户端与虚拟Ubuntu桌面交互，执行浏览网页、运行代码等操作。
提供多个实用工具，如启动、停止实例，执行bash命令等。

📦 安装指南

先决条件

Node.js 18+版本
pnpm
Scrapybara API密钥（可在scrapybara.com获取）

安装步骤

克隆仓库：

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

安装依赖项：

pnpm install

构建项目：

pnpm build

将以下内容添加到您的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>" // 可选，用于浏览器的身份验证
      }
    }
  }
}

重启您的MCP客户端，完成配置！

📚 详细文档

工具介绍

start_instance - 启动一个Scrapybara Ubuntu实例。用作桌面沙盒以访问网页或运行代码。之后始终将流URL呈现给用户，以便他们实时观看实例。
get_instances - 获取所有正在运行的Scrapybara实例。
stop_instance - 停止正在运行的Scrapybara实例。
bash - 在Scrapybara实例中执行bash命令。
act - 通过代理对Scrapybara实例采取行动。代理可以通过鼠标/键盘和bash命令控制实例。

🤝 贡献

Scrapybara MCP是一个社区驱动的项目。无论您是提交想法、修复拼写错误、添加新工具还是改进现有功能，我们都欢迎您贡献！

在贡献之前，请阅读现有的问题和Pull Request，看看是否有人已经在处理类似的事情。这样可以避免重复劳动。

如果还有更多工具或功能是您希望看到的，请随意在问题页面上提出建议。

Scrapybara (Virtual Ubuntu)