MCP 服务器

Scrapybara MCP

一个模型上下文协议服务器，它使 AI 客户端能够与虚拟 Ubuntu 桌面进行交互，允许它们浏览网页、运行代码，并通过鼠标/键盘操作和 bash 命令来控制实例。

Tools

start_instance

Start a Scrapybara Ubuntu instance. Use it as a desktop sandbox to access the web or run code. Always present the stream URL to the user afterwards so they can watch the instance in real time.

get_instances

Get all running Scrapybara instances.

stop_instance

Stop a running Scrapybara instance.

bash

Run a bash command in a Scrapybara instance.

act

Take action on a Scrapybara instance through an agent. The agent can control the instance with mouse/keyboard and bash commands.

README

<div id="toc" align="center"> <ul style="list-style: none"> <summary> <h1><img src="images/wow.gif" alt="Scrapybara" width="24"> Scrapybara MCP <img src="images/wow.gif" alt="Scrapybara" width="24"></h1> </summary> </ul> </div>

一个用于 Scrapybara 的模型上下文协议 (Model Context Protocol, MCP) 服务器。该服务器使 MCP 客户端（例如 Claude Desktop、Cursor 和 Windsurf）能够与虚拟 Ubuntu 桌面进行交互，并执行诸如浏览网页、运行代码等操作。

前提条件

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 命令来控制实例。