GBOX Android MCP

GBOX

GBOX は、AI エージェントがコンピューターやモバイルデバイスを操作するための環境を提供します。

モバイルシナリオ: エージェントは GBOX を使用して Android アプリを開発・テストしたり、Android 上でアプリを実行してさまざまなタスクを完了したりできます（モバイル自動化）。

デスクトップシナリオ: エージェントは GBOX を使用して、ブラウザー、ターミナル、VSCode などのデスクトップアプリを操作できます（デスクトップ自動化）。

MCP: GBOX MCP を Cursor や Claude Code など、お好みの任意のエージェントに接続することもできます。これらのエージェントは、コンピューターやモバイルデバイスを操作する機能を即座に利用できるようになります。

インストール

システム要件

• MacOS
  • バージョン: 10.15 以降
  • Homebrew

注: その他のプラットフォームで gbox を使用する場合は、npm パッケージ @gbox.ai/cli のインストール手順をご確認ください。GBOX.AI にログインして Web ベースのダッシュボードを利用することもできます。

インストール手順

クイックインストール（推奨）

オプション 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 Debug Bridge (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 を使用して、Claude Code/Cursor に MCP サーバーを設定します:

# 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 Code/Cursor の MCP 設定に貼り付けます:

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

注:

• 現在、GBOX MCP で操作できるのは Android 環境のみです。
• Cursor/Claude Code でローカルの Android デバイスを操作する必要がある場合は、ローカルデバイスの登録をご確認ください。

Android MCP のユースケース

ユースケース	デモ
Claude Code による Android アプリの開発・テスト
Claude Code による eコマースアプリの価格比較

環境

現在、GBOX は以下の環境をサポートしています:

• Android
• Linux デスクトップ/ブラウザー

Android 環境

Android 環境には 3 つのタイプがあり、ニーズに応じて選択できます。

1. クラウド仮想デバイス:

GBOX.AI にログインしてクラウド仮想デバイスを取得します。テストと開発に最適です。

2. クラウド物理デバイス:

GBOX.AI にログインしてクラウド物理デバイスを取得します。クラウド物理デバイスは実際の Android スマートフォンであり、本番シナリオで使用できます。

3. ローカル物理デバイス:

ご自身の物理デバイスを使用します ローカルデバイスを登録する。ローカルデバイスは、開発者モードが有効になっている任意の Android デバイスを使用できます。本番シナリオや個人利用に最適です。

Linux デスクトップ/ブラウザー環境

GBOX.AI にログインして Linux デスクトップ/ブラウザー環境を取得します。テストと開発に最適です。

gbox の開発

前提条件

• Go 1.21 以降
• Make
• 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

コントリビューション

コントリビューションを歓迎します！お気軽に Pull Request を送信してください。大きな変更の場合は、まず issue を作成して、変更したい内容について議論してください。

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 の下でライセンスされています - 詳細は LICENSE ファイルを参照してください。