Xcode MCP Server

🚀 Xcode MCP 服務器

Xcode MCP 服務器是一個為直接從大語言模型（LLM）應用構建 Xcode 項目而創建的模型上下文協議服務器。它提供了構建和測試 Xcode 項目的 Model Context Protocol 接口，使 AI 助手能夠通過標準化接口直接觸發構建、運行測試、監控進度並訪問日誌。

🚀 快速開始

Xcode MCP 服務器為開發者提供了便捷的方式來構建和測試 Xcode 項目。以下是使用該服務器的基本步驟：

1. 確保滿足先決條件，安裝所需的軟件和工具。
2. 按照安裝步驟克隆倉庫、安裝依賴並構建服務器。
3. 啟動服務器並在 Claude Desktop 中進行相應配置。

✨ 主要特性

• 靈活構建：使用自定義方案和配置構建 Xcode 項目。
• 精細測試：運行單元測試，支持細化控制，可運行特定測試或跳過某些測試。
• 全面報告：生成代碼覆蓋率報告，訪問詳細的構建和測試報告。
• 即時監控：即時流式傳輸構建和測試日誌。
• 標準輸出：以 JSON 格式輸出結果。
• 自動持久化：自動進行日誌持久化。

📦 安裝指南

先決條件

• Node.js 16+ 版本
• Xcode 命令行工具
• TypeScript
• 支持 MCP 的客戶端（例如 Claude Desktop）

安裝步驟

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

# 安裝依賴項
npm install

# 構建服務器
npm run build

💻 使用示例

與 Claude Desktop 一起使用

1. 啟動服務器

npm run start /path/to/build/logs/directory

2. 在 Claude Desktop 設置中

{
  "xcode-build": {
    "command": "node",
    "args": ["/path/to/the/xcode-mcp-server/build/index.js", "/path/to/your/project/folder"],
    "env": {
      "PATH": "/usr/bin:/bin:/usr/local/bin:/usr/sbin:/sbin"
    }
  }
}

可用工具

build_project

使用指定參數構建 Xcode 項目。

參數說明：

示例用法（在 Claude 中）：

build_project({
  projectPath: "/path/to/Project.xcodeproj",
  scheme: "MyApp",
  configuration: "Debug"
})

run_tests

運行單元測試，支持可選過濾。

參數說明：

示例用法（在 Claude 中）：

run_tests({
  projectPath: "/path/to/Project.xcodeproj",
  scheme: "MyAppTests",
  testIdentifier: "LoginTests/testSuccessfulLogin",
  skipTests: ["PerformanceTests/testLargeDataLoad"],
  configuration: "Debug"
})

📚 詳細文檔

日誌

• 所有日誌保存在指定基目錄下的 build-logs/ 目錄中。
• 構建操作生成：
  • 文本日誌（build-[時間戳].log）
  • JSON 格式日誌（build-[時間戳].log.json）
  • Xcode 報告（report-[時間戳].txt）
• 測試操作生成：
  • 測試日誌（test-[時間戳].log）
  • JSON 格式日誌（test-[時間戳].log.json）
  • 測試報告（test-report-[時間戳].txt）
  • 代碼覆蓋率報告（coverage-[時間戳].txt）
• 最新日誌（構建或測試）可通過 xcode-build/[時間戳]/latest 訪問。