Xcode

🚀 Xcode-MCP 工具文檔

Xcode-MCP 是一款功能強大的命令行工具，它能夠整合各類 Xcode 工具與現代設備控制功能，有效簡化 macOS 和 iOS 應用程序的開發、測試與分發流程，顯著提升開發者的工作效率。

🚀 快速開始

Xcode-MCP 工具整合了多個核心工具，可滿足應用開發、測試和分發的不同需求。以下為您介紹各核心工具及其使用示例。

✨ 主要特性

核心工具

• xcode-list-schemes：列出項目中的所有可用方案。
• xcode-test：執行測試並生成結果報告。
• xcode-archive：創建可用於分發的 IPA 包。
• xcode-clean：清除構建緩存和臨時文件。
• xcode-run-simulator：在指定的 iOS 模擬器上運行應用程序。
• xcode-run-device：在連接的真機設備上運行應用程序。

💻 使用示例

基礎用法

測試流程

1. 列出項目中的所有方案：

xcode-list-schemes --project /Users/username/Projects/MyApp.xcodeproj

2. 選擇一個方案並執行測試：

xcode-test --project /Users/username/Projects/MyApp.xcodeproj --scheme MyApp --configuration Debug

3. 打包應用進行分發：

xcode-archive --project /Users/username/Projects/MyApp.xcodeproj --scheme MyApp --configuration Release --output /Users/username/Desktop/MyApp.ipa

高級用法

使用 LLM 的示例工作流程

用戶提示給 Claude：

我需要檢查我的 Xcode 項目，運行一些測試，然後打包進行分發。

1. 首先使用 xcode-list-schemes 工具列出我在 /Users/username/Projects/MyApp.xcodeproj 項目的所有方案。
2. 在看到方案後，請為第一個可用的方案在 iPhone 14 模擬器上運行測試。
3. 然後使用 Release 配置打包應用。

預期工作流程：

1. Claude 執行 xcode-list-schemes 工具獲取所有方案：

Project path: /Users/username/Projects/MyApp.xcodeproj

2. 選擇第一個可用的方案並運行測試：

Project path: /Users/username/Projects/MyApp.xcodeproj
Scheme: MyApp
Destination: platform=iOS Simulator,name=iPhone 14

3. 打包應用進行分發：

Project path: /Users/username/Projects/MyApp.xcodeprj
Scheme: MyApp
Configuration: Release
ArchivePath: /Users/username/Desktop/MyApp.ipa

📚 詳細文檔

安全注意事項

該工具可以執行 Xcode 相關命令，存在一定的安全風險。請注意以下幾點：

⚠️ 重要提示

• 僅用於可信項目：只在可信賴的 Xcode 項目中使用此工具。
• 未知來源需謹慎：對於來自不知名來源的項目保持警惕。
• 避免敏感信息：不在構建參數中包含敏感信息。

開發要求

系統需求

• Node.js 16 或更高版本
• npm 6 或更高版本
• Xcode 14 或更高版本（所有功能）
• Xcode 16 或更高版本（devicectl 和真機功能需要）

本地開發與測試

# 克隆倉庫
git clone https://github.com/yourusername/xcode-mcp.git
cd xcode-mcp

# 安裝依賴項
npm install

# 啟動開發服務器
npm run dev

# 構建項目
npm run build

# 運行測試
npm test

提交代碼

1. 創建功能分支：

git checkout -b feature/new-feature

2. 提交更改：

git add .
git commit -m "添加新功能"

3. 推送到遠程倉庫：

git push origin feature/new-feature

4. 創建 Pull Request。

參考資料

• Xcode 文檔
• devicectl 文檔
• npm 官方文檔

通過遵循這些步驟，您可以有效地使用 Xcode-MCP 工具來管理您的開發流程。如需進一步幫助，請隨時查看我們的問題跟蹤頁面或直接在 GitHub 上提交新問題。

感謝您選擇 Xcode-MCP 工具！希望它能為您的開發工作帶來便利。