iOSアプリのテスト工程が、プロンプトひとつで完結する環境が整いつつあります。XcodeBuildMCPは、Claude CodeやCursorなどのAIエージェントにXcodeの操作権限を渡し、ビルドからテスト、デバッグ、実機デプロイまでを自律的に実行させるオープンソースツールです。
この記事でわかること
- XcodeBuildMCPが解決するiOS開発の課題
- 59種類のツールで何ができるのか
- シミュレータと実機それぞれのテスト方法
- Xcode 26.3のApple公式MCPとの連携
- セットアップ手順
iOSテスト自動化の壁
iOSアプリのテストには独特の面倒さがあります。Xcodeでビルドし、シミュレータを起動し、画面遷移を手動で確認し、実機に転送してもう一度確認する。XCTestを書いてもUIテストのメンテナンスコストは高く、セレクタの変更で壊れることも珍しくありません。
XcodeBuildMCPは、この一連の作業をAIエージェントに委ねる仕組みです。Sentry社がMITライセンスで公開しており、GitHubスター数は1,900を超えています。MCP（Model Context Protocol）サーバーとCLIの両方として動作し、AIエージェントがXcodeのビルドシステムに直接アクセスできます。
59種類のツールでできること
XcodeBuildMCPが提供するツールは59種類あり、4つのカテゴリに分かれています。
シミュレータ操作では、プロジェクトのビルドとシミュレータでの起動、スクリーンショットの取得、UIオートメーション（タップ、スワイプ、テキスト入力）を実行できます。AIエージェントはアクセシビリティツリーを読み取って画面構造を把握し、ボタンをタップしてフォームを埋め、画面遷移を確認するところまでを自動で行います。
実機テストでは、USBまたはWi-Fiで接続したiPhoneやiPadにアプリをデプロイし、ログをキャプチャしながらテストを実行します。コード署名がXcodeで設定済みであれば、追加の設定は不要です。
デバッグでは、LLDBデバッガのアタッチ、ブレークポイントの設定、変数のインスペクション、LLDBコマンドの直接実行が可能です。AIエージェントがクラッシュログを読んで原因を特定し、修正コードを提案するところまで一気に進みます。
UI自動化では、スクリーンショットを撮影してUIの見た目を検証したり、要素をタップして画面遷移のフローを確認したりできます。テストスクリプトやXCUITestのセレクタを書く必要はありません。
実際のワークフロー
Claude Codeで「ダークモードを追加して動作確認して」と指示した場合の流れを例に取ります。Claude Codeはまずソースコードを編集し、XcodeBuildMCPを通じてプロジェクトをビルドします。ビルドが成功するとシミュレータでアプリを起動し、設定画面に遷移してダークモードのトグルをタップします。スクリーンショットを撮影して見た目を確認し、問題がなければ完了を報告します。
この間、開発者はプロンプトを送るだけです。ビルドエラーが出た場合もAIエージェントが自動でコードを修正し、再ビルドを試みます。
Xcode 26.3との連携
2026年2月にリリースされたXcode 26.3には、Apple公式のMCPサーバーが組み込まれました。SwiftUIプレビューのレンダリング、Appleドキュメントの検索、Issue Navigatorのデータ取得といった機能を提供します。
XcodeBuildMCPはこのApple公式MCPサーバーをプロキシする機能を備えています。外部のAIエージェントからXcodeBuildMCPに接続するだけで、Apple公式のツールも含めたすべての機能にアクセスできます。MCPサーバーを2つ別々に設定する必要はありません。
Xcode内部のClaude・Codexコーディングエージェントからも利用できます。選択中のスキームとシミュレータを自動検出し、Xcodeがネイティブで提供するツールと重複するものは非表示にします。
セットアップ手順
インストール方法は2通りあります。HomebrewならNode.jsが不要です。
Homebrewの場合は、brew tap getsentry/xcodebuildmcp でタップを追加し、brew install xcodebuildmcp でインストールします。npmの場合は npm install -g xcodebuildmcp@latest を実行します。
MCPクライアントの設定ファイルには以下を追加します。
{
"mcpServers": {
"XcodeBuildMCP": {
"command": "npx",
"args": ["-y", "xcodebuildmcp@latest", "mcp"]
}
}
}
動作にはmacOS 14.5以降とXcode 16以降が必要です。npm経由の場合はNode.js 18以降も必要になります。
プロジェクトごとの設定は .xcodebuildmcp/config.yaml に記述します。スキーム名、プロジェクトパス、使用するシミュレータを指定しておくと、AIエージェントが毎回確認する手間がなくなります。
類似ツールとの違い
Apple公式のXcode MCPサーバーは、SwiftUIプレビューやドキュメント検索など、Xcode IDEに密接した機能を提供します。一方でXcodeBuildMCPは、xcodebuild CLIをラップする設計のため、Xcodeプロセスが起動していなくても動作します。CI/CDパイプラインやヘッドレス環境での自動化に向いているのはこちらです。
serve-sim（Evan Bacon氏が公開）はiOSシミュレータの画面をブラウザに配信するツールで、リモートからの画面確認が主な用途です。XcodeBuildMCPのようにビルドやデバッグまで含めた包括的な自動化は提供しません。
まとめ
XcodeBuildMCPは、iOSアプリのビルド・テスト・デバッグ・デプロイをAIエージェントから直接制御する環境を作ります。Xcode 26.3のApple公式MCPとの統合により、SwiftUIプレビューからLLDBデバッグまでをひとつの接続で扱えるようになりました。テストスクリプトを書く代わりに自然言語で指示を出す開発スタイルが、現実的な選択肢に入りつつあります。