AgentSkillsCN

mobile-debug-tools

跨平台移动 MCP 工具，支持设备交互、屏幕截图、触控模拟以及 UI 检查。适用于 iOS 模拟器与 Android 模拟器，可用于任何移动应用（Flutter、原生应用、React Native）。

SKILL.md
--- frontmatter
name: mobile-debug-tools
description: Cross-platform Mobile-MCP tools for device interaction, screenshots, touch simulation, and UI inspection. Works with iOS Simulator and Android Emulator for any mobile app (Flutter, native, React Native).

Mobile Debug Tools

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

Device & App Management

ToolPurpose
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

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

Touch Interaction

ToolPurpose
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

ToolPurpose
mcp__mobile-mcp__mobile_list_elements_on_screen画面上のUI要素を一覧表示

Input & Navigation

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

Device Settings

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

Typical Workflows

Visual Bug Investigation

code
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

code
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

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

Tips

Coordinate Finding

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

Screenshot Strategy

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

Element Selection

mobile_list_elements_on_screen の結果から：

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