Xcode MCP

🚀 Xcode MCP (模型上下文協議) 服務器

Xcode MCP (模型上下文協議) 服務器是一個全面的 MCP 服務器，它提供了對 Xcode 功能的編程式訪問，使 Claude 等 AI 助手能夠直接創建、構建、測試和管理 iOS/macOS 項目。

🚀 快速開始

Xcode MCP 服務器為 AI 助手提供了對 Xcode 功能的編程式訪問，讓其可以直接操作 iOS/macOS 項目。下面將詳細介紹其特性、安裝、配置和使用方法。

✨ 主要特性

項目管理

• 創建新的 Xcode 項目 - 使用 SwiftUI 模板生成完整的項目結構。
• 構建項目 - 使用可定製的配置編譯應用程序。
• 運行測試 - 執行單元測試和 UI 測試。
• 歸檔應用程序 - 創建用於分發的歸檔文件。
• 管理方案 - 列出並處理項目方案。

文件操作

• 創建 Swift 文件 - 直接將源代碼寫入文件系統。
• 修改 Info.plist - 以編程方式更新應用程序配置。
• 創建目錄 - 設置項目文件夾結構。
• 讀取文件 - 訪問和分析現有代碼。

模擬器管理

• 列出模擬器 - 查看所有可用的 iOS、watchOS 和 tvOS 模擬器。
• 啟動/關閉模擬器 - 控制模擬器的生命週期。
• 安裝應用程序 - 將應用程序部署到模擬器。
• 啟動應用程序 - 使用特定的捆綁 ID 運行應用程序。
• 捕獲屏幕截圖 - 以編程方式截取模擬器屏幕截圖。

📦 安裝指南

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

# 安裝依賴
npm install

# 構建項目
npm run build

🔧 詳細文檔

配置

將以下內容添加到你的 Claude Desktop 配置文件 (~/Library/Application Support/Claude/claude_desktop_config.json) 中：

{
  "mcpServers": {
    "xcode-mcp": {
      "command": "node",
      "args": ["/path/to/xcode-mcp/dist/index.js"],
      "env": {}
    }
  }
}

可用工具

開發

前提條件

• Node.js 16 及以上版本
• Xcode 14 及以上版本
• macOS 12 及以上版本

從源代碼構建

npm install
npm run build

在開發環境中運行

npm run dev

貢獻

我們歡迎貢獻！請參閱我們的 貢獻指南 瞭解詳細信息。

要求

• macOS：Xcode 集成必需。
• Xcode：必須安裝命令行工具。
• Node.js：版本 16 或更高。

故障排除

常見問題

模擬器未顯示：

• 確保 Xcode 已正確安裝。
• 運行 xcode-select --install 安裝命令行工具。

構建失敗：

• 檢查 Xcode 項目路徑是否正確。
• 驗證方案名稱是否完全匹配。

MCP 連接錯誤：

• 配置更改後重啟 Claude Desktop。
• 檢查日誌文件 ~/Library/Logs/Claude/mcp-server-xcode-mcp.log。

📄 許可證

本項目採用 MIT 許可證 - 詳情請參閱 LICENSE 文件。

🙏 致謝

• 基於 Anthropic 的 模型上下文協議 構建。
• 使用 Apple 的 Xcode 命令行工具。

📞 支持

• 問題反饋：GitHub 問題
• 討論交流：GitHub 討論
• 文檔維基：文檔維基

💻 使用示例

基礎用法

配置完成後，Claude 可以直接使用這些工具。以下是一些使用示例：

創建新項目

用戶："創建一個名為 MyApp 的新 iOS 應用程序"
Claude：*使用 xcode_create_project 生成項目結構*

構建項目

用戶："構建我的 iOS 應用程序"
Claude：*使用 xcode_build_project 並傳入適當的參數*

管理模擬器

用戶："顯示可用的模擬器"
Claude：*使用 xcode_list_simulators 顯示選項*