Mobile Debug Tools

クロスプラットフォーム対応のMobile-MCPツールリファレンス。iOS Simulator、Android Emulatorで動作。

Device & App Management

| Tool | Purpose | |------|---------| | mcp__mobile-mcp__mobile_list_available_devices | 利用可能なデバイスを一覧表示 | | mcp__mobile-mcp__mobile_list_apps | インストール済みアプリを一覧表示 | | mcp__mobile-mcp__mobile_launch_app | バンドルIDでアプリを起動 | | mcp__mobile-mcp__mobile_terminate_app | 実行中のアプリを終了 | | mcp__mobile-mcp__mobile_install_app | パスからアプリをインストール | | mcp__mobile-mcp__mobile_uninstall_app | アプリをアンインストール |

Screen Capture

| Tool | Purpose | |------|---------| | mcp__mobile-mcp__mobile_take_screenshot | スクリーンショット取得（base64） | | mcp__mobile-mcp__mobile_save_screenshot | スクリーンショットをファイル保存 | | mcp__mobile-mcp__mobile_get_screen_size | 画面サイズを取得 |

Touch Interaction

| Tool | Purpose | |------|---------| | mcp__mobile-mcp__mobile_click_on_screen_at_coordinates | 指定座標をタップ | | mcp__mobile-mcp__mobile_double_tap_on_screen | ダブルタップ | | mcp__mobile-mcp__mobile_long_press_on_screen_at_coordinates | 長押し | | mcp__mobile-mcp__mobile_swipe_on_screen | スワイプ操作 |

UI Inspection

| Tool | Purpose | |------|---------| | mcp__mobile-mcp__mobile_list_elements_on_screen | 画面上のUI要素を一覧表示 |

Input & Navigation

| Tool | Purpose | |------|---------| | mcp__mobile-mcp__mobile_type_keys | テキスト入力 | | mcp__mobile-mcp__mobile_press_button | ハードウェアボタン押下（Back, Home等） | | mcp__mobile-mcp__mobile_open_url | URLを開く（ディープリンクテスト） |

Device Settings

| Tool | Purpose | |------|---------| | mcp__mobile-mcp__mobile_set_orientation | 画面の向きを設定 | | mcp__mobile-mcp__mobile_get_orientation | 現在の向きを取得 |

Typical Workflows

Visual Bug Investigation

1. mobile_take_screenshot           # 現状確認
2. mobile_list_elements_on_screen   # UI要素の位置特定
3. mobile_click_on_screen_at_coordinates  # 操作実行
4. mobile_take_screenshot           # 結果確認

Form Input Testing

1. mobile_list_elements_on_screen   # 入力フィールド位置特定
2. mobile_click_on_screen_at_coordinates  # フィールドをタップ
3. mobile_type_keys                 # テキスト入力
4. mobile_click_on_screen_at_coordinates  # 送信ボタンタップ
5. mobile_take_screenshot           # 結果確認

Scroll & Navigation

1. mobile_swipe_on_screen           # スクロール
2. mobile_take_screenshot           # 表示確認
3. mobile_press_button              # 戻るボタン等

Tips

Coordinate Finding

mobile_list_elements_on_screen で要素のboundsを取得
中心座標を計算: x = left + width/2, y = top + height/2
スクロール: 画面中央から端へスワイプ

Screenshot Strategy

操作前にスクリーンショット（Before）
操作を実行
操作後にスクリーンショット（After）
視覚的に差分を比較

Element Selection

mobile_list_elements_on_screen の結果から：

label や identifier で要素を特定
frame から座標を計算
accessibility identifierがあれば最も確実