Xcodebuildmcp

🚀 XcodeBuildMCP 項目文檔

XcodeBuildMCP 是一款與 Xcode 交互的工具，藉助模型上下文協議 (MCP) 提供增強功能，能助力開發者更高效地管理和自動化 Xcode 項目。

🚀 快速開始

XcodeBuildMCP 能為開發者帶來諸多便利，下面為你介紹如何開啟使用之旅。

📦 安裝指南

1. 通過 npm 安裝：

   npm install -g xcodebuildmcp@1.3.1
   

2. 全局配置： 配置 XcodeBuildMCP 的運行環境變量，確保其正常工作。

✨ 主要特性

1. Xcode 項目管理

• 構建功能：支持快速構建 Xcode 項目。
• 診斷工具：提供詳細的環境檢查和依賴項狀態報告。

2. 模擬器管理

• 模擬器控制：支持啟動、重啟和停止模擬器。
• 屏幕截圖：捕獲當前模擬器屏幕並返回圖像路徑。

3. 應用程序實用工具

• 應用安裝：將應用程序快速安裝到指定設備或模擬器中。
• 日誌記錄：獲取即時日誌輸出以幫助調試。

🔍 為什麼需要 XcodeBuildMCP？

• 解決 Swift 宏問題：XcodeBuildMCP 默認啟用跳過 Swift 宏驗證的選項，以避免在使用 Swift Macros 的項目中出現錯誤。
• 自動化構建和測試：簡化 Xcode 構建和測試流程，提升開發效率。

💻 使用示例

故障排除 - 診斷工具使用方法

# 使用 npm 運行診斷工具
npm run xcodebuildmcp-diagnostic@1.3.1

# 或者直接執行
xcodebuildmcp-diagnostic

工具功能

• 系統檢查：驗證 Node.js 和操作系統版本。
• Xcode 配置：檢查 Xcode 安裝路徑和工具鏈狀態。
• 依賴項檢查：確認 idb、xcodebuild 等工具是否正確安裝。

演示案例

1. 使用 Cursor 自動修復構建錯誤

2. 屏幕截圖與 UI 自動化功能

3. 在 Claude Code 中構建和運行 iOS 應用

視頻鏈接

🤝 貢獻指南

如何貢獻

1. 本地配置：

   • 克隆倉庫。
   • 安裝依賴項：npm install

2. 代碼提交規範：

   • 遵循項目編碼風格和文檔標準。

3. 測試要求：

   • 在提交前運行單元測試，確保功能正常。

4. 問題報告：

   • 使用 GitHub 倉庫的 Issue 跟蹤和報告問題。

📄 許可證

XcodeBuildMCP 按照 MIT 許可證發佈，具體內容請參閱 LICENSE 文件。