iOS Debugger Agent

概要

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

コアワークフロー

ユーザーがより狭いアクションを要求しない限り、このシーケンスに従います。

1) 起動済みシミュレータの検出

• mcp__XcodeBuildMCP__list_sims を呼び出して、state が Booted のシミュレータを選択します。
• 起動済みのものがない場合、ユーザーに起動するよう依頼します（ユーザーが指示しない限り自動的に起動しないでください）。

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

• mcp__XcodeBuildMCP__session-set-defaults を以下の内容で呼び出します：
  • projectPath または workspacePath（リポジトリが使用している方）
  • 現在のアプリの scheme
  • 起動済みデバイスの simulatorId
  • オプション: configuration: "Debug"、useLatestOS: true

3) ビルド＋実行（リクエストされた場合）

• mcp__XcodeBuildMCP__build_run_sim を呼び出します。
• ビルドが失敗した場合、エラー出力を確認して再試行するか（オプションで preferXcodebuild: true を使用）、UI 操作を試みる前にユーザーにエスカレーションします。
• ビルドが成功した後、mcp__XcodeBuildMCP__describe_ui または mcp__XcodeBuildMCP__screenshot を呼び出してアプリが起動したことを確認してから、UI 操作に進みます。
• アプリが既にビルドされていて起動のみが要求されている場合、mcp__XcodeBuildMCP__launch_app_sim を使用します。
• bundle 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 を使用します。

ログとコンソール出力

• ログ開始: アプリ bundle id 付きで mcp__XcodeBuildMCP__start_sim_log_cap を実行します。
• ログ停止: mcp__XcodeBuildMCP__stop_sim_log_cap を実行して重要な行をまとめます。
• コンソール出力については、captureConsole: true を設定して、必要に応じて再起動します。

トラブルシューティング

• ビルドが失敗した場合、preferXcodebuild: true で再試行するかどうかをユーザーに問い合わせます。
• 不正なアプリが起動した場合、スキームと bundle id を確認します。
• UI 要素がタップできない場合、レイアウトの変更後に describe_ui を再実行します。