ios-debugger-agent

iOS デバッガーエージェント

概要

XcodeBuildMCP を使用して、現在のプロジェクトスキームを起動済みの iOS シミュレーター上でビルドして実行し、UI を操作してログを取得します。シミュレーターの制御、ログ、ビューの確認には MCP ツールを優先して使用してください。

基本ワークフロー

ユーザーから範囲を絞った操作を求められた場合を除き、次の手順に従ってください。

1) 起動済みシミュレーターを確認する

• mcp__XcodeBuildMCP__list_sims を呼び出し、状態が Booted のシミュレーターを選択します。
• 起動済みのシミュレーターがない場合は、ユーザーに起動を依頼してください（求められない限り、自動で起動しないでください）。

2) セッションのデフォルトを設定する

• 次の項目を指定して、mcp__XcodeBuildMCP__session-set-defaults を呼び出します。
  • projectPath または workspacePath（リポジトリで使用されている方）
  • 現在のアプリの scheme
  • 起動済みデバイスの simulatorId
  • 任意：configuration: "Debug"、useLatestOS: true

3) ビルドして実行する（依頼された場合）

• mcp__XcodeBuildMCP__build_run_sim を呼び出します。
• ビルドに失敗した場合は、エラー出力を確認して再試行します（必要に応じて preferXcodebuild: true を使用）。または、UI の操作を試みる前にユーザーに相談してください。
• ビルドに成功したら、UI の操作に進む前に、mcp__XcodeBuildMCP__describe_ui または mcp__XcodeBuildMCP__screenshot を呼び出してアプリの起動を確認します。
• アプリはすでにビルド済みで、起動のみを依頼された場合は、mcp__XcodeBuildMCP__launch_app_sim を使用します。
• バンドル ID が不明な場合：
  1. mcp__XcodeBuildMCP__get_sim_app_path
  2. mcp__XcodeBuildMCP__get_app_bundle_id

UI の操作とデバッグ

実行中のアプリの確認や操作を依頼された場合は、次のツールを使用してください。

• UI の説明：タップやスワイプの前に mcp__XcodeBuildMCP__describe_ui を呼び出します。
• タップ：mcp__XcodeBuildMCP__tap（id または label を優先し、必要な場合にのみ座標を使用します）。
• テキスト入力：フィールドにフォーカスを合わせてから mcp__XcodeBuildMCP__type_text を呼び出します。
• ジェスチャー：一般的なスクロールやエッジスワイプには mcp__XcodeBuildMCP__gesture を使用します。
• スクリーンショット：視覚的な確認には mcp__XcodeBuildMCP__screenshot を使用します。

ログとコンソール出力

• ログを開始するには、アプリのバンドル ID を指定して mcp__XcodeBuildMCP__start_sim_log_cap を呼び出します。
• ログを停止するには、mcp__XcodeBuildMCP__stop_sim_log_cap を呼び出し、重要な行を要約します。
• コンソール出力を取得するには、captureConsole: true を設定し、必要に応じてアプリを再起動します。

トラブルシューティング

• ビルドに失敗した場合は、preferXcodebuild: true を指定して再試行するか、ユーザーに確認してください。
• 間違ったアプリが起動した場合は、スキームとバンドル ID を確認してください。
• UI 要素を操作できない場合は、レイアウトの変更後に describe_ui を再実行してください。