DroidLume Agent Control

English · 简体中文

DroidLume 向けの npm 配布 CLI・MCP サーバー、および標準 AI エージェントスキル。

DroidLume Agent Control を使用すると、Codex、Claude Code、Cursor、Gemini、その他の AI エージェントが、DroidLume が管理するローカルの Android 仮想デバイスを制御できます。このツールは、構造化された CLI、ローカル MCP サーバー、macOS App Intents、オープンな Agent Skill を組み合わせており、不安定なスクリーン座標自動化を必要としません。

できること

• Android デバイスの作成、クローン、設定、起動、停止、修復、表示、削除

• ストリーミングサンドボックスアップロードによる APK ファイルのインストール

• アプリの一覧表示、起動、停止、アンインストール

• テキスト入力、座標タップ、スワイプ、Android キーイベントの送信

• スクリーンショットを PNG またはネイティブの MCP 画像コンテンツとして取得

• 機密情報を除去した DroidLume 診断情報のエクスポート

• 安定したデバイス ID、型付き JSON、コマンドスキーマ、タイムアウト、構造化エラーを返す

Related MCP server: DeepADB

必要条件

• Apple シリコン搭載 Mac

• macOS 14 以降

• DroidLume 1.1 以降

• Node.js 20 以降

インストール

CLI と MCP サーバーを npm からインストールし、エージェント用の Agent Skill を導入します:

npm install --global droidlume-agent-control
droidlume agent install codex

または、メンテナンス済みインストーラーを実行します（同じ 2 つの手順を実行します）:

curl -fsSL https://raw.githubusercontent.com/tageecc/droidlume-agent-control/main/install.sh | zsh -s -- codex

ターゲット:

all | codex | claude | cursor | agents

インストールを確認:

droidlume version
droidlume status --format pretty
droidlume device list --format pretty

MCP 設定

MCP 構成スニペットを生成:

droidlume agent config

手動で ZIP をダウンロードしない推奨構成:

{
  "mcpServers": {
    "droidlume": {
      "command": "npx",
      "args": ["-y", "droidlume-agent-control", "mcp"]
    }
  }
}

MCP サーバーは stdio を使用し、23 の型付きツール、3 つのリソース、Android アプリ検査プロンプトを公開します。スクリーンショットはネイティブの image/png MCP コンテンツとして返されます。

CLI の例

デバイスを起動してウィンドウを開く:

droidlume device start DEVICE_ID --show --timeout 180

APK をインストールして起動:

droidlume app install DEVICE_ID /absolute/path/application.apk --timeout 300
droidlume app launch DEVICE_ID com.example.app

Android 画面を検査:

droidlume device screenshot DEVICE_ID --output screen.png
droidlume input tap DEVICE_ID 540 1200
droidlume device screenshot DEVICE_ID --output screen-after.png

自動化の前にマシン契約を確認:

droidlume schema
droidlume schema device start

完全なコマンドリファレンス、MCP ガイド、状態と安全ルール、エラーリファレンスを参照してください。

アーキテクチャ

Codex / Claude / Gemini / Cursor / CI
                    │
        Agent Skill / npm MCP / npm CLI
                    │
       DroidLume Control API v1.0
          http://127.0.0.1:55777
                    │
          DroidLume RuntimeController
                    │
             Managed Android devices

公開 CLI と MCP サーバーは、DroidLume ホストアプリとループバックで通信します。デバイスのライフサイクル、アプリのインストール、スクリーンショット、入力、診断はすべて、ネイティブ macOS インターフェースで使用されるものと同じ RuntimeController を介して実行されます。

DroidLume Agent Control の利点

一般的な Android 自動化は、スクリーンショットの座標に依存しがちです。DroidLume Agent Control は、製品レベルの制御契約を提供します:

• 生の ADB シリアルではなく、安定したデバイス ID を提供

• ライフサイクル管理（開始、停止、再起動、修復）

• ストリーミングによる APK アップロード

• 型付き JSON とコマンドスキーマでエラーを削減

• タイムアウトと構造化エラーで堅牢な自動化を実現

• ネイティブ MCP イメージコンテンツとしてのスクリーンショット

CLI の例

デバイスを起動してウィンドウを開く:

droidlume device start DEVICE_ID --show --timeout 180

APK をインストールして起動:

droidlume app install DEVICE_ID /absolute/path/application.apk --timeout 300
droidlume app launch DEVICE_ID com.example.app

Android 画面を検査:

droidlume device screenshot DEVICE_ID --output screen.png
droidlume input tap DEVICE_ID 540 1200
droidlume device screenshot DEVICE_ID --output screen-after.png

自動化前にマシンスキーマを確認:

droidlume schema
droidlume schema device start

完全な コマンドリファレンス、MCP ガイド、状態と安全ルール、エラーリファレンス を参照してください。

アーキテクチャ

Codex / Claude / Gemini / Cursor / CI
                    │
        Agent Skill / npm MCP / npm CLI
                    │
       DroidLume Control API v1.0
          http://127.0.0.1:55777
                    │
          DroidLume RuntimeController
                    │
             Managed Android devices

公開 CLI と MCP サーバーは、ループバックを介して DroidLume ホストアプリと通信します。デバイスのライフサイクル、アプリのインストール、入力、診断は、ネイティブアプリが使用するのと同じ RuntimeController を介して実行されます。

DroidLume Agent Control を選ぶ理由

一般的な Android 自動化は、スクリーンショットの座標に依存することが多く、不安定です。DroidLume Agent Control は、安定したデバイス UUID、コマンドスキーマ、タイムアウト、構造化エラーを提供し、AI エージェントが確実に操作できるようにします。

• スクリーン座標ではなく、安定したデバイス UUID を使用

• すべての操作で型付き JSON を使用

• コマンドごとのスキーマとタイムアウトを公開

• エラーは構造化され、診断情報を含む

• アプリのインストールはサンドボックスアップロードで安全

FAQ

DroidLume とは何ですか?

MCP サーバーはどのように動作しますか?

他の AI ツールでも使えますか?

スクリーンショットはどのように返されますか?

デバイス ID は安定していますか?

アプリのインストールは安全ですか?

CLI はスクリプトで利用できますか?

エージェントはどのように Skill を取得しますか?

診断情報はどのように収集されますか?

アンインストールするにはどうすればよいですか?

リンク

• DroidLume 公式サイト

• Agent Control ドキュメント

• npm パッケージ

• サポート

ライセンス

このリポジトリ内の Agent Skill とドキュメントは MIT ライセンス の下で提供されます。DroidLume アプリケーションのバイナリと商標は、それぞれの製品利用規約に従います。# DroidLume Agent Control

English · 简体中文

npm で配布される CLI と MCP サーバー、および DroidLume 用のオープンな AI エージェントスキルです。

DroidLume Agent Control を使用すると、Codex、Claude Code、Cursor、Gemini などの AI エージェントが、DroidLume が管理するローカルの Android 仮想デバイスを制御できます。これは、構造化された CLI、ローカル MCP サーバー、macOS の App Intents、およびオープンな Agent Skill を組み合わせたもので、不安定なスクリーン座標の自動化には依存しません。

できること

• Android デバイスの作成、クローン、設定、起動、停止、修復、表示、削除

• ストリーミング方式のサンドボックスアップロードによる APK ファイルのインストール

• Android アプリの一覧表示、起動、停止、アンインストール

• テキスト入力、座標タップ、スワイプ、Android キーイベントの送信

• スクリーンショットを PNG またはネイティブ MCP 画像コンテンツとして取得

• 機密情報を除去した DroidLume 診断情報のエクスポート

• 安定したデバイス ID、型付き JSON、コマンドスキーマ、タイムアウト、構造化エラーを返す

必要条件

• Apple シリコン Mac

• macOS 14 以降

• DroidLume 1.1 以降

• Node.js 20 以降

インストール

CLI と MCP サーバーを npm からインストールし、エージェント用の Agent Skill をインストールします:

npm install --global droidlume-agent-control
droidlume agent install codex

または、同じ 2 つの手順を実行するメンテナンス済みインストーラーを実行します:

curl -fsSL https://raw.githubusercontent.com/tageecc/droidlume-agent-control/main/install.sh | zsh -s -- codex

対象:

all | codex | claude | cursor | agents

インストールを確認:

droidlume version
droidlume status --format pretty
droidlume device list --format pretty

MCP 設定

MCP 構成スニペットを生成します:

droidlume agent config

推奨される構成 (手動で ZIP をダウンロードする必要はありません):

{
  "mcpServers": {
    "droidlume": {
      "command": "npx",
      "args": ["-y", "droidlume-agent-control", "mcp"]
    }
  }
}

MCP サーバーは stdio を使用し、23 個の型付きツール、3 つのリソース、および Android アプリの検査プロンプトを公開します。スクリーンショットは、ネイティブの image/png MCP コンテンツとして返されます。

CLI の例

デバイスを起動してウィンドウを開く:

droidlume device start DEVICE_ID --show --timeout 180

APK をインストールして起動する:

droidlume app install DEVICE_ID /absolute/path/application.apk --timeout 300
droidlume app launch DEVICE_ID com.example.app

Android 画面を検査する:

droidlume device screenshot DEVICE_ID --output screen.png
droidlume input tap DEVICE_ID 540 1200
droidlume device screenshot DEVICE_ID --output screen-after.png

自動化の前にマシンリーダブルなスキーマを確認する:

droidlume schema
droidlume schema device start

完全な コマンドリファレンス、MCP ガイド、状態と安全規則、エラーリファレンス を参照してください。

アーキテクチャ

Codex / Claude / Gemini / Cursor / CI
                    │
        Agent Skill / npm MCP / npm CLI
                    │
       DroidLume Control API v1.0
          http://127.0.0.1:55777
                    │
          DroidLume RuntimeController
                    │
             Managed Android devices

パブリック CLI と MCP サーバーは、DroidLume ホストアプリとローカル通信します。デバイスのライフサイクル、アプリのインストール、スクリーンショット、入力、診断はすべて、ネイティブアプリが使用するのと同じ RuntimeController を介して実行されます。droidlume-mcp は stdio を使用し、droidlume CLI は 127.0.0.1 上のホストアプリと通信します。

なぜ DroidLume Agent Control なのか

• 不安定なスクリーン座標の代わりに、安定したデバイス ID を使用

• すべての操作で型付き JSON を返す

• コマンドスキーマ、タイムアウト、構造化エラーを提供

• ローカルホスト上で動作し、クラウドに依存しない

• macOS App Intents とオープンな Agent Skill の両方をサポート

インストール

CLI と MCP サーバーを npm からインストールし、エージェント用の Agent Skill をセットアップします:

droidlume device start DEVICE_ID --show --timeout 180

または、保守済みインストーラーを実行します (同じ 2 つの手順を実行):

droidlume app install DEVICE_ID /absolute/path/application.apk --timeout 300
droidlume app launch DEVICE_ID com.example.app

ターゲット:

droidlume device screenshot DEVICE_ID --output screen.png
droidlume input tap DEVICE_ID 540 1200
droidlume device screenshot DEVICE_ID --output screen-after.png

インストールの確認:

droidlume schema
droidlume schema device start

よくある質問

その他の質問については、DroidLume サポート を参照してください。

ライセンス

このリポジトリ内の Agent Skill とドキュメントは MIT ライセンス の下で提供されます。DroidLume アプリケーションのバイナリと商標は、それぞれの製品利用規約に従います。