XcodeBuildMCP
iOSおよびmacOSプロジェクトで作業する際にエージェントが使用するツールを提供するModel Context Protocol（MCP）サーバーおよびCLIです。
XcodeBuildMCP MCPで何ができますか？
- Build for simulator — AIに、指定されたスキームとプロジェクトパスを使用して、特定のシミュレータ用にiOSまたはmacOSアプリをコンパイルするよう依頼します。
- Prepare test products — AIに、テストを実行せずに、選択したシミュレータを対象としたポータブルなテストバンドルを生成させます。
- Run prepared tests — AIに、以前にビルドしたテストプロダクトを指定されたシミュレータ上で実行するよう指示します。
- List available tools — AIに、呼び出し可能なCLIコマンドとMCPサーバー機能の全セットを表示するよう依頼します。
- Check for updates — AIに、インストール済みバージョンを確認し、必要に応じてツールをその場でアップグレードするよう要求します。
ドキュメント
A Model Context Protocol (MCP) サーバーおよびCLIで、iOSおよびmacOSプロジェクトで作業する際にエージェントが使用できるツールを提供します。
インストール
MobileBuildMCPは、2つのモードを持つ単一のパッケージとして提供されます。CLI（ターミナルで直接使用）とMCPサーバー（AIコーディングエージェント用）です。どちらのインストール方法でも両方が利用できます。
オプションA — Homebrew
brew tap getsentry/xcodebuildmcp
brew install mobilebuildmcp
オプションB — npm（Node.js 18+）
npm install -g mobilebuildmcp@latest
どちらかのインストールを確認します:
mobilebuildmcp --help
MCPクライアントを接続する
Cursor、Claude Code、Codex向けのドロップイン設定スニペットは、公式ドキュメントページ MCP Clients にあります。ほとんどのクライアントは、グローバルインストールなしで npx -y mobilebuildmcp@latest mcp を介してMCPサーバーをオンデマンドで実行することもできます。
要件
- macOS 14.5以降
- Xcode 16.x以降
- Node.js 18.x以降（Homebrewインストールでは不要）
スキル
MobileBuildMCPには、2つのオプションのエージェントスキルが含まれるようになりました。
-
MCPスキル: MCPサーバーのツールの使用方法についてエージェントに事前指示を与えます（MCPサーバー使用時はオプション）。
-
CLIスキル: CLIの操作方法についてエージェントに事前指示を与えます（CLI使用時におすすめ）。
グローバルバイナリでインストールする場合:
mobilebuildmcp init
または、グローバルインストールなしでnpx経由で直接インストールする場合:
npx -y mobilebuildmcp@latest init
スキルのインストールの詳細については、Agent Skills を参照してください。
注意事項
- MobileBuildMCPは、Swiftマクロを使用するプロジェクトをビルドする際のエラーを回避するために、xcodebuildにマクロ検証のスキップを要求します。
- デバイスツールを使用するには、Xcodeでコード署名が設定されている必要があります。Device Code Signing を参照してください。
プライバシー
MobileBuildMCPは、内部ランタイムエラーテレメトリのみにSentryを使用します。詳細とオプトアウト手順については、Privacy & Telemetry を参照してください。
CLI
MobileBuildMCPは、統合されたコマンドラインインターフェースを提供します。mcp サブコマンドはMCPサーバーを起動し、その他のコマンドはすべてツールへの直接ターミナルアクセスを提供します:
# Install globally
npm install -g mobilebuildmcp@latest
# Start the MCP server (for MCP clients)
mobilebuildmcp mcp
# List available tools
mobilebuildmcp tools
# Build for simulator
mobilebuildmcp simulator build --scheme MyApp --project-path ./MyApp.xcodeproj
# Prepare portable test products without running tests
mobilebuildmcp simulator build --scheme MyApp --project-path ./MyApp.xcodeproj --simulator-name "iPhone 17" --build-for-testing --test-products-path ./MyApp.xctestproducts
# Run previously prepared test products
mobilebuildmcp simulator test --test-products-path ./MyApp.xctestproducts --simulator-name "iPhone 17"
アップデートを確認し、その場でアップグレードします:
mobilebuildmcp upgrade --check
mobilebuildmcp upgrade --yes
CLIは、ステートフルな操作（ログキャプチャ、デバッグなど）のためにワークスペースごとのデーモンを使用し、必要に応じて自動起動します。完全なドキュメントについては、CLI guide を参照してください。
ドキュメント
- インストール: https://github.com/getsentry/xcodebuildmcp.com/blob/main/app/docs/_content/installation.mdx
- セットアップ: https://github.com/getsentry/xcodebuildmcp.com/blob/main/app/docs/_content/setup.mdx
- MCPクライアント: https://github.com/getsentry/xcodebuildmcp.com/blob/main/app/docs/_content/clients.mdx
- CLIの使用方法: https://github.com/getsentry/xcodebuildmcp.com/blob/main/app/docs/_content/cli.mdx
- 設定とオプション: https://github.com/getsentry/xcodebuildmcp.com/blob/main/app/docs/_content/configuration.mdx
- ツールリファレンス: https://github.com/getsentry/xcodebuildmcp.com/blob/main/app/docs/_content/tools.mdx
- トラブルシューティング: https://github.com/getsentry/xcodebuildmcp.com/blob/main/app/docs/_content/troubleshooting.mdx
- プライバシー: https://github.com/getsentry/xcodebuildmcp.com/blob/main/app/docs/_content/privacy.mdx
- スキル: https://github.com/getsentry/xcodebuildmcp.com/blob/main/app/docs/_content/skills.mdx
- コントリビューション: https://github.com/getsentry/xcodebuildmcp.com/blob/main/app/docs/_content/contributing.mdx
ライセンス
このプロジェクトはMITライセンスの下でライセンスされています。詳細については、LICENSE ファイルを参照してください。 サードパーティのライセンス通知については、THIRD_PARTY_LICENSES ファイルを参照してください。 npmパッケージの帰属については、THIRD_PARTY_PACKAGE_LICENSES ファイルを参照してください。