xcodebuildmcp

XcodeBuildMCP 是一個強大的模型上下文協定 (MCP) 伺服器與 CLI 工具，旨在協助 AI 代理管理 iOS、macOS、watchOS、tvOS 與 visionOS 的開發生命週期。它作為代理與 Apple 開發堆疊之間的介面，透過結構化的工具工作流程取代手動執行 xcodebuild、xcrun 與 simctl。對於需要在不離開終端機或代理輔助環境的情況下，自動化複雜構建週期、執行自動化 UI 測試或在模擬器與實體裝置上進行除錯的開發者來說，它是理想的選擇。

• 完整支援 Xcode 專案與工作區探索，包括配置方案列出與構建設定檢查。

• 全面的模擬器管理，包括開機、清除、定位操控與應用程式生命週期控制 (安裝/啟動)。

• 針對實體硬體的進階裝置工作流程，涵蓋構建、測試以及符合程式碼簽署要求的部署。

• 整合 LLDB 除錯器連線，使代理能夠附加到處理程序、設定中斷點並檢查變數與堆疊追蹤。

• 強大的 UI 自動化功能，包括截圖擷取、基於座標互動的視圖層級檢查，以及點擊、滑動與文字輸入等模擬動作。

• 統一支援 Swift Package Manager (SwiftPM) 專案與用於生成新應用程式範本的專案腳手架。

• 從已連線的模擬器與實體裝置高效串流並擷取日誌，以便即時進行錯誤診斷。

• 使用者應透過會話配置定義專案、方案與目標預設值，以減少重複參數的負擔。

• 代理在發起任何構建或測試動作之前，必須呼叫 session_show_defaults 以確保正確的上下文處於啟動狀態。

• 某些進階功能 (如實體裝置互動與 UI 自動化) 可能需要在 .xcodebuildmcp/config.yaml 檔案中進行特定配置，才能在預設的模擬器工具集之外啟用。

• 涉及 Swift Macros 的專案應使用提供的跳過巨集驗證 (skip-macro-validation) 設定，以防止構建時出現錯誤。

• 該工具作為有狀態的代理助手運作，利用每個工作區的守護程序 (daemon) 來無縫處理諸如日誌串流與除錯會話等持久性任務。