mobilebuildmcp

MobileBuildMCP

xcodebuild、xcrun、simctlを直接実行する代わりに、MobileBuildMCP ツールを使用してください。

機能：

• セッションのデフォルト設定：プロジェクト、スキーム、シミュレーター、デバイスのデフォルトを設定し、繰り返しパラメーターを指定しなくて済むようにします
• プロジェクトの検出：Xcode プロジェクト／ワークスペースの検索、スキームの一覧表示、ビルド設定の確認
• シミュレーターのワークフロー：iOS シミュレーターでアプリをビルド、実行、テスト、インストール、起動し、シミュレーターの状態（起動、消去、位置情報、外観）を管理します
• デバイスのワークフロー：コード署名を使用して、実機でアプリをビルド、テスト、インストール、起動します
• macOS のワークフロー：macOS アプリケーションをビルド、実行、テストします
• ログの取得：シミュレーターやデバイスからログをストリーミングおよび取得します
• LLDB デバッグ：デバッガーの接続、ブレークポイントの設定、スタックトレースや変数の確認、LLDB コマンドの実行
• UI 自動化：スクリーンショットの取得、座標付きのビュー階層の確認、タップ／スワイプ／ジェスチャーの実行、テキスト入力、ハードウェアボタンの押下
• SwiftPM：Swift Package Manager プロジェクトのビルド、実行、テスト、管理
• プロジェクトのひな形作成：新しい iOS／macOS プロジェクトのテンプレートを生成します

デフォルトでは、シミュレーターのワークフローツールのみが有効です。デバイス、macOS、デバッグ、UI 自動化などの機能が利用できない場合は、ユーザーが MobileBuildMCP を設定して有効にする必要があります。ワークフローの設定については、https://github.com/getsentry/xcodebuildmcp.com/blob/main/app/docs/_content/configuration.mdx を参照してください。

ステップ 1：セッションコンテキストを確立する

• セッション内で最初にビルド／実行／テストの操作を行う前に、session_show_defaultsを呼び出してください。
• デフォルト設定にプロジェクト／ワークスペースのコンテキストが欠けている、または正しくない場合にのみ、discover_projsを使用してください。
• session_show_defaultsと並行して、見込みでプロジェクトの検出を実行しないでください。
• シミュレーターでの実行が目的の場合、ビルドと実行を別々に呼び出すのではなく、ビルドと実行をまとめて行うツールを優先してください。
• ユーザーが両方を明示的に要求した場合を除き、ビルドのみの処理に続けてビルドと実行を行わないでください。

ステップ 2：ワークフローごとのツールの利用可否を確認する

• すべてのツールがデフォルトで有効になっているわけではありません。ツールの利用可否は、有効になっているワークフローによって異なります。
• 予想されるツールが見つからない場合は、まず有効なワークフローを確認してください。
• .mobilebuildmcp/config.yamlで有効なワークフローを更新し、更新を反映するためにセッションを再読み込み／再起動するようユーザーに依頼してください。

ステップ 3：コンテキストを明確に報告する

• 実行に使用したアクティブなデフォルト設定のコンテキスト（プロジェクト／ワークスペース、スキーム、シミュレーター／デバイス）を返してください。
• 失敗した場合は、正確に失敗したステップと、次に実行可能なコマンド／ツール呼び出しを含めてください。