XcodeBuildMCP

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

インストール

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

オプション 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 クライアントで確認できます。ほとんどのクライアントでは、グローバルにインストールせずに 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

スキルのインストール方法について詳しくは、エージェントスキルをご覧ください。

注記

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

プライバシー

MobileBuildMCP は、内部のランタイムエラーのテレメトリーにのみ Sentry を使用します。詳細とオプトアウト方法については、プライバシーとテレメトリーをご覧ください。

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 ガイドをご覧ください。

ドキュメント

• インストール：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ファイルをご覧ください。