majiayu000 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があれば最も確実