XcodeBuildMCP

一個模型上下文協定（MCP）伺服器與命令列工具，提供代理在處理 iOS 與 macOS 專案時所需的工具。

GitHub

6.2k

你可以用 Xcode Build MCP 做什麼？

為模擬器建置應用程式 — 要求代理程式使用方案與專案路徑執行 simulator build，以編譯您的 iOS 或 macOS 專案。
在特定模擬器上執行測試 — 使用 simulator test 搭配測試產品路徑與模擬器名稱，來執行先前準備好的測試套件。
準備測試產品但不執行 — 呼叫 simulator build 並加上 --build-for-testing 與 --test-products-path，以產生可攜帶的 .xctestproducts 套件。
為 AI 客戶端啟動 MCP 伺服器 — 執行 mcp 子命令，讓您的程式碼代理程式能透過 MCP 協定使用所有建置與測試工具。
從命令列列出可用工具 — 使用 tools 命令來探索目前環境中可用的操作。
檢查並套用更新 — 執行 upgrade --check 或 upgrade --yes 來原地更新命令列工具。

文件

一個模型上下文協定 (MCP) 伺服器與命令列工具，為處理 iOS 和 macOS 專案的代理提供工具。

安裝

XcodeBuildMCP 以單一套件形式發布，提供兩種模式：用於直接終端機操作的 CLI，以及用於 AI 編碼代理的 MCP 伺服器。任一種安裝方式都能同時取得兩者。

選項 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 客戶端中找到。大多數客戶端也可以透過 npx -y xcodebuildmcp@latest mcp 按需執行 MCP 伺服器，無需全域安裝。

需求

macOS 14.5 或更新版本
Xcode 16.x 或更新版本
Node.js 18.x 或更新版本（Homebrew 安裝則不需要）

技能

XcodeBuildMCP 現在包含兩個可選的代理技能：

MCP 技能：引導代理如何使用 MCP 伺服器的工具（使用 MCP 伺服器時可選）。
CLI 技能：引導代理如何操作 CLI（使用 CLI 時建議安裝）。

使用全域二進位檔安裝：

xcodebuildmcp init

或透過 npx 直接安裝，無需全域安裝：

npx -y xcodebuildmcp@latest init

有關安裝技能的更多資訊，請參閱代理技能。

注意事項

XcodeBuildMCP 要求 xcodebuild 跳過巨集驗證，以避免在建置使用 Swift Macros 的專案時發生錯誤。
裝置工具需要在 Xcode 中配置程式碼簽署。請參閱裝置程式碼簽署。

隱私權

XcodeBuildMCP 僅使用 Sentry 進行內部執行階段錯誤遙測。詳情與退出說明，請參閱隱私權與遙測。

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 指南。

文件

安裝：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 檔案。