another-android

Another - Android デバイスの操作

Another MCP サーバーを通じて Android デバイスを操作できます。画面の確認、デバイスとのやり取り、タスクの自動化に、これらのツールを使用してください。

セットアップ

Another デスクトップアプリを起動し、MCP サーバーを有効にする必要があります（Settings でデフォルトで有効になっています）。

MCP 設定（Claude Code、Claude Desktop、Cursor など）に追加します。

{
  "mcpServers": {
    "another": {
      "type": "http",
      "url": "http://localhost:7070/mcp"
    }
  }
}

ワークフロー

常に次の順序で実行してください。

1. デバイスの一覧表示で、利用可能なデバイスを確認します
2. 接続して、制御セッションを確立します
3. スクリーンショットを撮影して、現在の画面の状態を確認します
4. タッチ、テキスト、ボタン、スワイプなどを使って操作します
5. もう一度スクリーンショットを撮影して、結果を確認します
6. 完了したら切断します

利用可能なツール

デバイス管理

ツール	機能
another_list_devices	接続されている Android デバイスをすべて一覧表示します
another_connect_device	デバイスに接続します（scrcpy 制御セッションを開始します）
another_disconnect_device	現在のデバイスから切断します

画面の確認

ツール	機能
another_take_screenshot	画面を PNG 画像としてキャプチャします

入力

ツール	機能
another_press_button	ハードウェアボタンを押します：home、back、recents、power、volume_up、volume_down
another_send_text	フォーカスされている入力欄にテキストを入力します
another_send_touch	正規化座標（0.0～1.0）でタッチイベント（down、up、move）を送信します
another_send_scroll	指定した位置で、指定した差分だけスクロールします
another_swipe	ある点から別の点へスワイプします（正規化座標 0.0～1.0）

アプリとシェル

ツール	機能
another_launch_app	パッケージ名でアプリを起動します（例：com.android.chrome）
another_open_url	デバイスのデフォルトブラウザーで URL を開きます
another_shell	任意の adb shell コマンドを実行し、出力を取得します

WiFi

ツール	機能
another_wifi_enable	USB 接続されたデバイスを WiFi デバッグモードに切り替えます
another_wifi_connect	IP アドレスでデバイスに接続します
another_wifi_disconnect	WiFi デバイスから切断します
another_get_device_ip	USB 接続されたデバイスの WiFi IP アドレスを取得します

座標系

タッチ、スワイプ、スクロールの各ツールでは、0.0～1.0 の正規化座標を使用します。

• (0.0, 0.0) = 左上隅
• (1.0, 1.0) = 右下隅
• (0.5, 0.5) = 画面中央

よく使う操作パターン

項目をタップする

another_send_touch { action: "down", x: 0.5, y: 0.5 }
another_send_touch { action: "up", x: 0.5, y: 0.5 }

タップしてから確認する

1. another_take_screenshot  (see what's on screen)
2. another_send_touch       (tap where you need to)
3. another_take_screenshot  (verify the result)

入力欄にテキストを入力する

1. Tap the input field with another_send_touch
2. another_send_text { text: "hello world" }

ページを下にスクロールする

another_send_scroll { x: 0.5, y: 0.5, dx: 0.0, dy: -1.0 }

スワイプして戻る、または移動する

another_swipe { from_x: 0.0, from_y: 0.5, to_x: 0.5, to_y: 0.5 }

ボタンで移動する

another_press_button { button: "home" }
another_press_button { button: "back" }
another_press_button { button: "recents" }

アプリを開いて操作する

1. another_launch_app { package: "com.android.chrome" }
2. Wait briefly, then another_take_screenshot
3. Interact as needed

画面上の要素を見つける

スクリーンショットを撮影し、画面を確認して位置を特定してから、座標を使って操作します。スクリーンショットは、デバイスに何が表示されているかを把握するための主な手段です。

シェルコマンドを実行する

another_shell { command: "pm list packages" }
another_shell { command: "dumpsys battery" }
another_shell { command: "settings get system screen_brightness" }

ヒント

• 操作する前に、必ず最初にスクリーンショットを撮影してください。タップする場所を判断するには、画面を確認する必要があります。
• 操作後にスクリーンショットを撮影して、正常に動作したことを確認してください。
• 画面を確認する必要がない操作（バッテリーの確認、パッケージの一覧表示、デバイス情報の取得など）には、シェルコマンドを使用してください。
• スワイプ時間のデフォルトは 300ms です。よりゆっくり、慎重にスワイプするには、duration_ms を大きくしてください。
• 操作する前に接続してください。press_button、send_text、send_touch、swipe などのツールを使うには、another_connect_device によるアクティブな接続が必要です。
• *list_devices、shell、take_screenshot、wifi_ ツール**は scrcpy 接続なしで動作し、adb のみを必要とします。