AI导哈

AI设备操作环境

GBOX为AI代理提供操作计算机和移动设备的环境，支持移动自动化、桌面自动化及与多种AI代理的集成。

  • by babelcloud
  • Go
  • 本地部署
  • 181 星标
  • 更新于
在 GitHub 查看 babelcloud/gru-sandbox

使用说明

GBOX（注：GBOX是一个品牌或产品名称，直接翻译为中文时通常保留原名，但根据语境，有时也可意译为“G系列盒装产品”或“GBOX系列”，具体需根据上下文确定。此处为直译保留原名。）

GBOX 为人工智能代理提供操作计算机和移动设备的环境。

移动场景： 您的代理可以使用GBOX来开发/测试安卓应用，或者在安卓设备上运行应用以完成各种任务（移动自动化）。

桌面场景： 您的代理可以使用GBOX来操作桌面应用程序，如浏览器、终端、VSCode等（桌面自动化）。

MCP: （此缩写在中文中没有直接对应的翻译，通常保留原样或根据上下文具体解释，如“最小成本路径”等，但在此处作为一般缩写，可直接译为“MCP（最小成本路径/其他具体含义，视上下文而定）”） 你也可以将GBOX MCP连接到你喜欢的任何代理，比如Cursor、Claude Code。这些代理将立即获得操作电脑和移动设备的能力。

安装

系统要求

注：在其他平台上使用gbox时，请检查npm包 @gbox.ai/cli（可译为：“@gbox.ai 命令行界面”或保持原样，因为“@gbox.ai/cli”本身可能是一个特定的命令行工具或接口名称，在中文中通常直接保留原样以指代该工具或接口） 以获取安装说明。您也可以登录 GBOX.AI（注：此翻译保持了原英文名称的格式，若需意译或根据具体语境调整，请提供更多上下文信息） 使用基于网络的仪表板。

安装步骤

快速安装（推荐）

选项1：仅安装GBOX CLI

curl -fsSL https://raw.githubusercontent.com/babelcloud/gbox/main/install.sh | bash

这仅安装了GBOX CLI。当需要时，额外的依赖项（如ADB、frpc、Appium）将自动安装，或者您也可以稍后使用以下命令进行安装：

gbox setup

选项2：安装时包含所有依赖项（一键式设置）

curl -fsSL https://raw.githubusercontent.com/babelcloud/gbox/main/install.sh | bash -s -- --with-deps

这会一次性安装所有内容：

  • GBOX CLI（命令行界面）
  • Node.js 和 npm（如未安装）
  • Android调试桥（ADB）
  • FRP 客户端（frpc）
  • Appium服务器、驱动程序和插件

非交互模式：

# CLI only
curl -fsSL https://raw.githubusercontent.com/babelcloud/gbox/main/install.sh | bash -s -- -y

# With all dependencies
curl -fsSL https://raw.githubusercontent.com/babelcloud/gbox/main/install.sh | bash -s -- -y --with-deps

替代安装方法

通过 Homebrew（macOS）：

brew install gbox

通过 npm（Linux/Windows）：

npm install -g @gbox.ai/cli

设置依赖项

如果你只安装了GBOX CLI，你可以随时安装所有命令依赖项：

gbox setup

或者以交互方式安装它们：

gbox setup -y

更新GBOX CLI

保持您的GBOX CLI为最新版本：

使用安装脚本：

# Interactive update (will prompt if already installed)
curl -fsSL https://raw.githubusercontent.com/babelcloud/gbox/main/install.sh | bash

# Force update without prompt
curl -fsSL https://raw.githubusercontent.com/babelcloud/gbox/main/install.sh | bash -s -- --update

# Skip update even if newer version available
curl -fsSL https://raw.githubusercontent.com/babelcloud/gbox/main/install.sh | bash -s -- --update=false

使用 Homebrew（macOS）：

brew upgrade gbox

使用 npm（Linux/Windows）：

npm update -g @gbox.ai/cli

开始使用

# Login to gbox.ai
gbox login

# Connect your Android device (dependencies will be installed automatically if missing)
gbox device-connect

# Export MCP config and merge into Claude Code/Cursor
gbox mcp export --merge-to claude-code
gbox mcp export --merge-to cursor

命令行使用方法

检查 GBOX CLI 参考手册 以了解详细用法。

SDK 使用方法

检查 GBOX SDK 参考手册 用于详细使用说明。

将GBOX用作MCP服务器（需要登录）

使用GBOX CLI配置MCP服务器以连接到您的Claude Code/Cursor：

# Export MCP config for Cursor
gbox mcp export --merge-to cursor

# Export MCP config for Claude Code
gbox mcp export --merge-to claude-code --scope project

或者将以下内容复制粘贴到您的Claude代码/Cursor MCP配置中：

{
  "mcpServers": {
    "gbox-android": {
      "command": "npx",
      "args": [
        "-y",
        "@gbox.ai/mcp-server@latest"
      ]
    }
  }
}

注：

  • 目前，GBOX MCP仅能控制Android环境。
  • 如果您需要使用Cursor/Claude Code来控制您的本地Android设备，请检查 注册本地设备

Android MCP 应用场景

用例 演示
克劳德开发/测试安卓应用代码
克劳德：在电商应用上比较价格

环境

目前，GBOX 支持以下环境：

  • 安卓
  • Linux 桌面/浏览器

Android 环境

有三种类型的Android环境，您可以根据自己的需求进行选择：

1. 云虚拟设备：

登录至 GBOX.AI（注：此翻译直接保留了原英文名称，若需意译或结合具体上下文翻译，需更多信息） 获取云虚拟设备。非常适合测试和开发。

2. 云物理设备：

登录至 GBOX.AI（直接音译，若需意译，可理解为“GBOX人工智能平台”或“GBOX智能系统”，具体根据上下文确定） 获取一个云物理设备。云物理设备是一台真实的安卓手机，可用于生产环境场景。

3. 本地物理设备：

使用您自己的实体设备 注册本地设备您的本地设备可以是任何已启用开发者模式的Android设备。最适合用于生产环境和个人使用。

Linux 桌面/浏览器环境

登录到 GBOX.AI（注：这个名称可能是一个特定公司或项目的名称，直接翻译为中文可能无法准确传达其含义，因此保留原样。如果“GBOX”和“.AI”有特定含义或品牌背景，应根据具体情况进行翻译或解释。） 获取一个Linux桌面/浏览器环境。非常适合测试和开发。

开发gbox

先决条件

  • Go 1.21或更高版本
  • 制作
  • pnpm（通过 corepack）
  • Node.js 16.13 或更高版本

构建

# Build for current platform
make build

# Build for all platforms
make build-all

# Create distribution package
make dist

运行服务

# MCP Server
cd packages/mcp-server && pnpm dev

# MCP Inspector
cd packages/mcp-server && pnpm inspect

贡献

我们欢迎贡献！请随时提交拉取请求。对于重大更改，请先打开一个议题进行讨论，说明您想要做出的更改。

  1. 为仓库创建分支
  2. 创建你的特性分支（git checkout -b username/feature-name)
  3. 提交您的更改（git commit -m 'Add some feature'）
  4. 推送到分支（git push origin username/feature-name)
  5. 打开一个拉取请求（Pull Request）

关于本地开发与调试需要了解的事项

许可证

这个项目采用Apache License 2.0许可协议——详见 许可证 文件中有详细信息。

相关 MCP