XcodeBuildMCP

iOSおよびmacOSプロジェクトで作業するAIエージェント向けのツールを提供する、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サーバーを実行することも可能です。

Related MCP server: MCP Xcode Server

要件

• 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マクロを使用するプロジェクトのビルド時にエラーを回避するため、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

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

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ファイルを参照してください。