Polarvista Xcode MCP Server

🚀 Xcode MCP 服務器

Xcode MCP 服務器提供了一個標準化的 Model Context Protocol 接口，可用於直接從大語言模型應用程序構建和測試 Xcode 項目。它讓 AI 助手能輕鬆觸發構建、運行測試、監控進度並訪問日誌，為開發工作帶來極大便利。

🚀 快速開始

Xcode MCP 服務器提供了一個 Model Context Protocol 接口，用於構建和測試 Xcode 項目。它使 AI 助手能夠直接觸發構建、運行測試、監控進度並訪問日誌，通過一個標準化的接口。

✨ 主要特性

• 使用自定義方案和配置構建 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 項目。

參數：

• projectPath（必填）：.xcodeproj 或 .xcworkspace 文件的路徑
• scheme（必填）：構建方案名稱
• configuration（可選）：構建配置（Debug/Release，默認為 Debug）
• destination（可選）：構建目標（默認為 "platform=iOS Simulator,name=iPhone 15 Pro"）

示例用法在 Claude 中：

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

run_tests

運行單元測試，具有可選過濾功能。

參數：

• projectPath（必填）：.xcodeproj 或 .xcworkspace 文件的路徑
• scheme（必填）：測試方案名稱
• testIdentifier（可選）：特定測試的標識符（例如 'MyTests/testExample'）
• skipTests（可選）：要跳過的測試標識符數組
• configuration（可選）：構建配置（Debug/Release，默認為 Debug）
• destination（可選）：測試目標（默認為 "platform=iOS Simulator,name=iPhone 15 Pro"）

示例用法在 Claude 中：

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

📚 詳細文檔

日誌

• 所有日誌存儲在指定基目錄下的 build-logs/ 文件夾中
• 構建操作創建：
  • 純文本日誌（build-[timestamp].log）
  • JSON 格式日誌（build-[timestamp].log.json）
  • Xcode 報告（build-[timestamp].xcresult）
• 測試操作創建：
  • 純文本日誌（test-[timestamp].log）
  • JSON 格式日誌（test-[timestamp].log.json）
  • Xcode 報告（test-[timestamp].xcresult）

您可以通過以下 URL 訪問最新的構建和測試結果：

http://localhost:8080