xcodebuildmcp-cli

XcodeBuildMCP CLI

このスキルは AI エージェント向けです。XcodeBuildMCP CLI を、MCP ツール呼び出しに代わる低オーバーヘッドな手段として位置づけています。エージェントはすでにシェルコマンドを実行でき、CLI はスキーマ交換のコストなしで同じツール群を提供します。生の xcodebuild、xcrun、simctl よりも CLI を優先してください。

この CLI を使う場面（機能とワークフロー）

• ビルド、テスト、実行、デバッグ、ログ記録、UI 自動化の機能が必要な場合。
• シミュレーターやデバイスの管理機能が必要な場合。
• AI に最適化されたツールやツールの応答が必要な場合。
• プロジェクトの検出機能（スキーム、バンドル ID、アプリのパス）が必要な場合。

コマンドの確認

--help を使って、ワークフロー、ツール、引数を確認します。

xcodebuildmcp --help
xcodebuildmcp tools --help
xcodebuildmcp tools --json
xcodebuildmcp <workflow> --help
xcodebuildmcp <workflow> <tool> --help

注：

• 複雑な引数には --json '{...}' を使用し、機械可読な結果が必要な場合は --output json を使用します（推奨しません）。

よくあるワークフロー

シミュレーターでビルドして実行する

1. シミュレーターを一覧表示し、デバイス名または UDID を選択します。
2. ビルドして実行します。

アプリやプロジェクトの詳細が不明な場合：

xcodebuildmcp simulator discover-projs --workspace-root .
xcodebuildmcp simulator list-schemes --project-path ./MyApp.xcodeproj
xcodebuildmcp simulator list-sims

1 つのコマンドでアプリをビルド、インストール、起動するには：

xcodebuildmcp simulator build-run-sim --scheme MyApp --project-path ./MyApp.xcodeproj --simulator-name "iPhone 17 Pro"

ビルドのみ

ビルドエラーがないことだけを確認したい場合は、アプリを実行せずにビルドできます。

xcodebuildmcp simulator build-sim --scheme MyApp --project-path ./MyApp.xcodeproj --simulator-name "iPhone 17 Pro"

テストを実行する

テストを実行する場合は、test-sim ツールを使用できます。

xcodebuildmcp simulator test-sim --scheme MyAppTests --project-path ./MyApp.xcodeproj --simulator-name "iPhone 17 Pro"

実機にインストールして起動する

xcodebuildmcp device list-devices
xcodebuildmcp device build-device --scheme MyApp --project-path ./MyApp.xcodeproj
xcodebuildmcp device get-device-app-path --scheme MyApp --project-path ./MyApp.xcodeproj
xcodebuildmcp device get-app-bundle-id --app-path /path/to/MyApp.app
xcodebuildmcp device install-app-device --device-id DEVICE_UDID --app-path /path/to/MyApp.app
xcodebuildmcp device launch-app-device --device-id DEVICE_UDID --bundle-id com.example.MyApp --app-path /path/to/MyApp.app

シミュレーターのログを取得する

xcodebuildmcp logging start-sim-log-cap --simulator-id SIMULATOR_UDID --bundle-id com.example.MyApp
xcodebuildmcp logging stop-sim-log-cap --log-session-id LOG_SESSION_ID

実行中のアプリをデバッグする（シミュレーター）

1. アプリを起動します。
2. アプリが完全に起動したら、デバッガーをアタッチします。

まだ実行されていない場合は起動します：

xcodebuildmcp simulator launch-app-sim --bundle-id com.example.MyApp --simulator-id SIMULATOR_UDID

デバッガーをアタッチします：

デバッガーをアタッチする前に、アプリが完全に起動するまで 1～2 秒待つことをおすすめします。

xcodebuildmcp debugging debug-attach-sim --bundle-id com.example.MyApp --simulator-id SIMULATOR_UDID

ブレークポイントの追加や削除、スタックや変数の確認、任意の LLDB コマンドの実行については、デバッグのヘルプを参照してください：

xcodebuildmcp debugging --help

UI の確認と入力の自動化

UI アクセシビリティツリーのスナップショットを取得し、タップ、スワイプ、文字入力を行い、スクリーンショットを撮影します：

xcodebuildmcp ui-automation snapshot-ui --simulator-id SIMULATOR_UDID
xcodebuildmcp ui-automation tap --simulator-id SIMULATOR_UDID --x 200 --y 400
xcodebuildmcp ui-automation type-text --simulator-id SIMULATOR_UDID --text "hello"
xcodebuildmcp ui-automation screenshot --simulator-id SIMULATOR_UDID --return-format path

すべての UI 自動化ツールを確認するには、UI 自動化のヘルプを参照してください：

xcodebuildmcp ui-automation --help

macOS アプリのビルド／実行

xcodebuildmcp macos build-macos --scheme MyMacApp --project-path ./MyMacApp.xcodeproj
xcodebuildmcp macos build-run-macos --scheme MyMacApp --project-path ./MyMacApp.xcodeproj

すべての macOS ツールを確認するには、macOS のヘルプを参照してください：

xcodebuildmcp macos --help

SwiftPM パッケージのワークフロー

xcodebuildmcp swift-package list --package-path ./MyPackage
xcodebuildmcp swift-package build --package-path ./MyPackage
xcodebuildmcp swift-package test --package-path ./MyPackage

すべての SwiftPM ツールを確認するには、SwiftPM のヘルプを参照してください：

xcodebuildmcp swift-package --help

プロジェクトの検出

xcodebuildmcp project-discovery discover-projs --workspace-root .
xcodebuildmcp project-discovery list-schemes --project-path ./MyApp.xcodeproj
xcodebuildmcp project-discovery get-app-bundle-id --app-path ./Build/MyApp.app

すべてのプロジェクト検出ツールを確認するには、プロジェクト検出のヘルプを参照してください：

xcodebuildmcp project-discovery --help

新しいプロジェクトのスキャフォールディング

利用可能なオプションを確認するため、スキャフォールディングツールの --help を参照することをおすすめします。 簡単な例を以下に示します：

xcodebuildmcp project-scaffolding scaffold-ios-project --project-name MyApp --output-path ./Projects
xcodebuildmcp project-scaffolding scaffold-macos-project --project-name MyMacApp --output-path ./Projects

すべてのプロジェクトスキャフォールディングツールを確認するには、プロジェクトスキャフォールディングのヘルプを参照してください：

xcodebuildmcp project-scaffolding --help

デーモンに関する注意（ステートフルツール）

ステートフルツール（ログ、デバッグ、動画録画、バックグラウンド実行）は、ワークスペースごとのデーモンを介して実行されます。このデーモンは自動的に起動します。ステートフルツールでエラーが発生する場合は、デーモンプロセスを手動で管理できます。

xcodebuildmcp daemon status
xcodebuildmcp daemon restart

すべてのデーモンコマンドを確認するには、デーモンのヘルプを参照してください：

xcodebuildmcp daemon --help