Android Mobile Mcp

Android Mobile MCP

概要

Android Mobile MCP は、Model Context Protocol と Android デバイスの自動化を連携させ、UI 操作、アプリ管理、画面キャプチャを通じて AI エージェントが Android デバイスを操作できるようにします。

MCP の設定

{
  "mcpServers": {
    "android-mobile-mcp": {
      "command": "uvx",
      "args": ["android-mobile-mcp"]
    }
  }
}

前提条件

1. Android デバイスを USB またはネットワーク経由で接続します
2. Android デバイスで USB デバッグを有効にします
3. ADB（Android Debug Bridge）をインストールします

ツール一覧

画面分析

mobile_dump_ui - UI 要素を階層構造の JSON として抽出します

• 画面の XML を解析し、フォーカス可能な要素とテキストコンテンツを特定します
• 各操作可能な要素の中心座標を計算します
• 親子要素の関係を構造化して返します

mobile_take_screenshot - 現在の画面状態をキャプチャします

• 視覚的な分析に使用する PNG 画像データを返します

タッチ操作

mobile_click - 指定した座標をクリックします

• 現在の UI 状態に照らして座標を検証します
• 座標を検証するため、事前に mobile_dump_ui を呼び出す必要があります
• 無効な領域や操作できない領域のクリックを防止します

mobile_swipe - スワイプ操作を実行します

• 2 つの座標間で指定した方向にスワイプします
• ジェスチャーの速度を制御するため、継続時間を設定できます

テキスト入力

mobile_type - フォーカスされたフィールドにテキストを入力します

• 現在アクティブな入力フィールドにテキストを送信します
• Enter キーによる自動送信を任意で指定できます

ナビゲーション

mobile_key_press - システムボタンを押します

• ハードウェアキーと仮想キーに対応しています：BACK、HOME、RECENT、ENTER

アプリ管理

mobile_list_apps - インストール済みのアプリケーションを一覧表示します

• システムアプリと起動できないパッケージを除外します
• ユーザーがアクセスできるアプリケーションのみを返します

mobile_launch_app - パッケージ名を指定してアプリケーションを起動します

• 起動を試みる前にパッケージの存在を検証します