Scrapybara MCP
2025.03.19
10
JavaScript虚拟桌面交互浏览器自动化开发环境管理浏览器自动化开发效率
Scrapybara MCP 是一个基于 Model Context Protocol 的服务，旨在为 MCP 客户端（如 Claude Desktop、Cursor 和 Windsurf）提供与虚拟 Ubuntu 桌面交互的能力。该服务支持多种操作，包括浏览网页、运行代码等。
View on GitHub
Overview
基本能力
产品定位
Scrapybara MCP 是一个为 MCP 客户端提供虚拟 Ubuntu 桌面交互能力的服务，支持浏览器自动化和开发效率提升。
核心功能
- 启动和管理 Scrapybara Ubuntu 实例
- 在实例中运行 bash 命令
- 通过代理控制实例（鼠标/键盘操作和 bash 命令）
适用场景
- 浏览器自动化测试
- 远程代码执行和开发环境管理
- 自动化任务执行
工具列表
- start_instance: 启动 Scrapybara Ubuntu 实例，提供实时流 URL
- get_instances: 获取所有运行中的 Scrapybara 实例
- stop_instance: 停止运行中的 Scrapybara 实例
- bash: 在 Scrapybara 实例中运行 bash 命令
- act: 通过代理控制实例（鼠标/键盘操作和 bash 命令）
常见问题解答
- 需要 Node.js 18+ 和 pnpm 作为前置依赖
- 需要 Scrapybara API 密钥
使用教程
使用依赖
- 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" or "openai"
"AUTH_STATE_ID": "<YOUR_AUTH_STATE_ID>" // Optional, for authenticating the browser
}
}
}
}
- 重启 MCP 客户端
调试方式
- 确保所有依赖已正确安装
- 检查 API 密钥是否正确配置
- 查看实例运行状态和日志