XcodeBuildMCP

iOSおよびmacOSプロジェクトで作業する際にエージェントが使用するツールを提供するModel Context Protocol（MCP）サーバーおよびCLIです。

GitHub

6.2k

Xcode Build MCPで何ができますか？

Build an app for the simulator — エージェントにスキームとプロジェクトパスを指定して simulator build を実行させ、iOS または macOS プロジェクトをコンパイルします。
Run tests on a specific simulator — テストプロダクトパスとシミュレータ名を指定して simulator test を使用し、事前に準備したテストバンドルを実行します。
Prepare test products without running them — --build-for-testing と --test-products-path を指定して simulator build を呼び出し、ポータブルな .xctestproducts バンドルを生成します。
Start the MCP server for an AI client — mcp サブコマンドを実行し、コーディングエージェントが MCP プロトコル経由ですべてのビルドツールとテストツールにアクセスできるようにします。
List available tools from the CLI — tools コマンドを使用して、現在の環境で利用可能な操作を確認します。
Check for and apply updates — upgrade --check または upgrade --yes を実行し、CLI をその場で更新します。

ドキュメント

iOSおよびmacOSプロジェクトの作業時にエージェントが使用するためのツールを提供するModel Context Protocol (MCP) サーバー兼CLIです。

インストール

XcodeBuildMCPは、ターミナルで直接使用するCLIとAIコーディングエージェント向けのMCPサーバーという2つのモードを単一のパッケージで提供します。どちらのインストール方法でも両方を利用できます。

オプションA — Homebrew

brew tap getsentry/xcodebuildmcp
brew install xcodebuildmcp

オプションB — npm (Node.js 18以上)

npm install -g xcodebuildmcp@latest

いずれかのインストールを確認:

xcodebuildmcp --help

MCPクライアントの接続

Cursor、Claude Code、Codex用の設定スニペットは、公式ドキュメントページのMCP Clientsにあります。ほとんどのクライアントは、グローバルインストールなしでnpx -y xcodebuildmcp@latest mcp経由でMCPサーバーをオンデマンドで実行することもできます。

要件

macOS 14.5以降
Xcode 16.x以降
Node.js 18.x以降 (Homebrewインストールでは不要)

スキル

XcodeBuildMCPには、現在2つのオプションのエージェントスキルが含まれています。

MCPスキル: MCPサーバーのツールの使用方法に関する指示をエージェントに提供します (MCPサーバー使用時はオプション)。
CLIスキル: CLIの操作方法に関する指示をエージェントに提供します (CLI使用時に推奨)。

グローバルバイナリでインストールする場合:

xcodebuildmcp init

または、グローバルインストールせずにnpx経由で直接インストールする場合:

npx -y xcodebuildmcp@latest init

スキルのインストールに関する詳細は、Agent Skillsを参照してください。

注意事項

XcodeBuildMCPは、Swift Macrosを使用するプロジェクトのビルド時のエラーを回避するため、xcodebuildにマクロ検証をスキップするよう要求します。
デバイスツールを使用するには、Xcodeでコード署名が設定されている必要があります。Device Code Signingを参照してください。

プライバシー

XcodeBuildMCPは、内部ランタイムエラーテレメトリにのみSentryを使用します。詳細とオプトアウト手順については、Privacy & Telemetryを参照してください。

CLI

XcodeBuildMCPは統合コマンドラインインターフェースを提供します。mcpサブコマンドはMCPサーバーを起動し、その他のコマンドはすべてツールへの直接ターミナルアクセスを提供します。

# Install globally
npm install -g xcodebuildmcp@latest

# Start the MCP server (for MCP clients)
xcodebuildmcp mcp

# List available tools
xcodebuildmcp tools

# Build for simulator
xcodebuildmcp simulator build --scheme MyApp --project-path ./MyApp.xcodeproj

# Prepare portable test products without running tests
xcodebuildmcp 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
xcodebuildmcp simulator test --test-products-path ./MyApp.xctestproducts --simulator-name "iPhone 17"

アップデートを確認し、その場でアップグレード:

xcodebuildmcp upgrade --check
xcodebuildmcp upgrade --yes

CLIは、ステートフルな操作 (ログキャプチャ、デバッグなど) のためにワークスペースごとのデーモンを使用し、必要に応じて自動起動します。完全なドキュメントについてはCLI guideを参照してください。

ドキュメント

インストール: https://xcodebuildmcp.com/docs/installation
セットアップ: https://xcodebuildmcp.com/docs/setup
MCPクライアント: https://xcodebuildmcp.com/docs/clients
CLIの使用法: https://xcodebuildmcp.com/docs/cli
設定とオプション: https://xcodebuildmcp.com/docs/configuration
ツールリファレンス: https://xcodebuildmcp.com/docs/tools
トラブルシューティング: https://xcodebuildmcp.com/docs/troubleshooting
プライバシー: https://xcodebuildmcp.com/docs/privacy
スキル: https://xcodebuildmcp.com/docs/skills
コントリビューション: https://xcodebuildmcp.com/docs/contributing

ライセンス

このプロジェクトはMITライセンスの下でライセンスされています。詳細はLICENSEファイルを参照してください。サードパーティのライセンス通知については、THIRD_PARTY_LICENSESファイルを参照してください。 npmパッケージの帰属表示については、THIRD_PARTY_PACKAGE_LICENSESファイルを参照してください。