コマンドライン

device-mcp-cli は Device MCP のコマンドラインです。アプリで行う操作や AI エージェントに頼む操作を、ターミナル、シェルスクリプト、Makefile、CI から実行できます。デバイスの一覧表示、スクリーンショット、画面の読み取り、タップや入力、アプリの起動やインストール、位置情報の設定、ライセンスの管理ができます。

どのコマンドも JSON で結果を返せるので、スクリプトではテキストを解析しなくても、jq で結果を読み取れます。

1. インストール#

• Homebrew：brew install --cask device-mcp で、device-mcp-cli が PATH に追加されます。
• Web サイトからダウンロードした場合：ターミナルで次のコマンドを一度だけ実行して、PATH に追加します。

sudo ln -sf "/Applications/Device MCP.app/Contents/MacOS/device-mcp-cli" /usr/local/bin/device-mcp-cli

このリンクは、Device MCP がアップデートされても使えます。次のコマンドで確認します。

device-mcp-cli --version
device-mcp-cli --help                  # every command
device-mcp-cli help apps launch        # one command, with its options

2. 仕組み#

• コマンドは Device MCP が実行します：デバイスのコマンドは、Mac 上の Device MCP アプリに送られます。Device MCP が起動していない場合、コマンドは Device MCP を開く前に確認します。--launch を付けると確認せずに開き（スクリプトではこちらを使います）、--no-launch を付けると開きません。status、mcp、tools、logs は Device MCP を開きません。
• 使うデバイス：--device（または -d）でデバイスの名前か UDID を指定します。指定しない場合は devices select で選んだデバイスを使い、それもなければ Device MCP で選択されているデバイスを使います。
• JSON：どのコマンドにも --json を付けられます。エラーも JSON で返ります。
• 主導権はあなたに：アプリのインストールと削除、リンクを開く操作、クリップボードの読み取りと変更、Build & Run は、AI エージェントの場合と同じく、まず Device MCP であなたに確認します。承認を参照してください。デバイスのペアリング解除とライセンスの無効化は、常に確認します。
• 無料版と Pro：どのコマンドも Device MCP の無料版で使えます。ただし、Build & Run、アプリのインストール、3D ビューインスペクタには Device MCP Pro が必要です。無料版でミラーリングできるのは、一度に 1 台のデバイスだけです。

3. コマンド#

<device> はデバイスの名前か UDID です。どのコマンドにも --json を、デバイスのコマンドには --device を付けられます。

デバイス#

画面#

タッチとキー#

アプリ#

デバイスの設定#

Device MCP#

その他#

4. 使用例#

サインインして結果を確認する#

シェルスクリプトや CI のステップで使える、アプリのスモークテストです。

set -e
device-mcp-cli apps launch com.example.myapp --launch
device-mcp-cli wait-for "Sign In"
device-mcp-cli type "[email protected]" --field "Email"
device-mcp-cli type - --field "Password" < password.txt
device-mcp-cli tap --text "Sign In"
device-mcp-cli wait-for "Welcome" --timeout 20 || {
  device-mcp-cli screenshot -o failure.png
  exit 1
}

すべてのデバイスのスクリーンショットを撮る#

device-mcp-cli devices --json |
  jq -r '.devices[] | select(.state == "ready" or .state == "running") | .udid' |
  while read -r udid; do device-mcp-cli screenshot --device "$udid" -o ~/Desktop/; done

画面上の要素をタップする#

elements は画面の要素を ref 付きで一覧表示します。jq で目的の要素を見つけて、タップします。

REF=$(device-mcp-cli elements --json | jq -r '.elements[] | select(.label == "General") | .ref')
device-mcp-cli tap --ref "$REF"

ほかの言語と場所でアプリをテストする#

device-mcp-cli apps launch com.example.myapp --language fr --locale fr_FR
device-mcp-cli location set 48.8584 2.2945
device-mcp-cli open-url "myapp://map"
device-mcp-cli appearance dark

新しいシミュレータでビルドして実行する#

device-mcp-cli simulators start --model "iPhone 17 Pro" --launch
device-mcp-cli build-and-run ~/Projects/MyApp/MyApp.xcodeproj --scheme MyApp
device-mcp-cli screenshot -o ~/Desktop/myapp.png

バグを画面収録する#

device-mcp-cli record start
# reproduce the bug on the device
device-mcp-cli record stop

Mac をセットアップする#

CI 用の Mac や、新しく加わったチームメンバーの Mac で実行します。

device-mcp-cli license activate --launch < license-key.txt
device-mcp-cli mcp on
device-mcp-cli mcp setup claude
device-mcp-cli status

5. JSON と終了コード#

--json を付けると、コマンドは JSON オブジェクトを 1 つ出力します。たとえば、device-mcp-cli devices --json の出力は次のとおりです。

{
  "devices" : [
    {
      "connection" : "USB",
      "current" : true,
      "kind" : "iphone",
      "mirroringStopped" : false,
      "model" : "iPhone 17 Pro",
      "name" : "My iPhone",
      "osVersion" : "27.0.1",
      "platform" : "iOS",
      "state" : "ready",
      "udid" : "00008150-000A1B2C3D4E5F60"
    }
  ]
}

デバイスの kind は iphone、ipad、watch、android、simulator、emulator のいずれかです。state は ready、locked、blocked（issue と fix に理由と対処法が入ります）、connecting、running、shut_down、booting、shutting_down、creating、starting のいずれかです。

エラーの場合は {"error": {"code": "…", "message": "…"}} を出力します。

成功したコマンドは、終了コード 0 で終了します。

6. AI エージェントと使う#

エージェントもコマンドラインを使えます。たとえば、アプリのテストスクリプトや CI のステップを書かせることができます。

• 「iPhone でサインインして、ホーム画面が読み込まれなかったら失敗するスクリプトを書いて。」
• 「オンボーディングのすべての画面のスクリーンショットを撮る CI ステップを追加して。」

エージェントが実行したコマンドは、Agent タブに device-mcp-cli として表示されます。エージェントのアクティビティを参照してください。