Xcode MCP Server

Xcode MCP Server是一個基於Model Context Protocol的服務器，為AI助手提供全面的Xcode集成功能，包括項目管理、文件操作、構建測試、CocoaPods和Swift包管理以及iOS模擬器工具等。

開發者工具操作系統自動化 #Xcode集成 #AI開發工具 #iOS開發 .TypeScript

評分 : 3.5分

下載量 : 225

更新時間 : 2025-04-28

什麼是Xcode MCP服務器？

Xcode MCP服務器是一款專為AI助手設計的工具，它允許您通過標準化接口輕鬆管理Xcode項目、執行構建測試、操作文件以及控制iOS模擬器。

如何使用Xcode MCP服務器？

只需啟動服務器並按照提示進行配置，即可開始使用。您可以創建新項目、添加文件、運行測試或管理模擬器。

適用場景

適用於開發者需要快速設置項目環境、調試應用或生成自動化報告的場景。

主要功能

項目管理支持創建、加載和操作標準Xcode項目、工作區及Swift包。

文件操作讀取、寫入文件，處理二進制數據，搜索特定內容。

構建與測試執行構建任務、運行測試並分析代碼質量。

模擬器控制啟動、關閉模擬器，安裝應用並錄製屏幕。

Swift包管理添加、移除依賴項並更新包。

優勢與侷限性

優勢

強大的Xcode集成能力

支持多種項目類型

易於擴展的新工具集成

侷限性

需要macOS系統支持

部分高級功能可能對初學者複雜

如何使用

安裝Xcode MCP服務器

確保您的Mac已安裝最新版本的Xcode，並運行安裝腳本以完成所有依賴項的配置。

啟動服務器

啟動服務器後，AI助手可以開始調用您的Xcode項目。

配置權限

在配置文件中指定允許訪問的目錄，確保安全性和兼容性。

使用案例

創建新項目通過調用API創建一個全新的iOS應用項目。

運行測試執行項目中的單元測試並顯示失敗情況。

常見問題

為什麼需要安裝Xcode才能使用此服務器？

如何解決權限錯誤？

🚀 Xcode MCP 服務器使用說明

Xcode MCP 服務器是一個用於特定操作的服務器，支持工具註冊與調用，可對文件操作進行路徑驗證和錯誤處理，還能進行自定義配置。

🚀 快速開始

註冊工具

在 src/tools/ 目錄下創建一個新的工具類別，並在其中註冊工具：

// src/tools/build/index.ts
export const build = new Tool({
  name: 'build',
  description: 'Builds an Xcode project or workspace.',
  parameters: {
    // 定義參數 schema
  },
})

使用工具

通過發送 HTTP 請求來調用工具：

curl -X POST http://localhost:3000/tools/build \
     -H "Content-Type: application/json" \
     -d '{"parameter": "value"}'

✨ 主要特性

可配置性：支持配置允許目錄和日誌級別。
安全性：進行路徑驗證，將文件操作限制在允許的目錄內，同時對工具執行進行錯誤處理。
擴展性：可以自定義工具分類和擴展日誌記錄。

📦 安裝指南

請按照以下步驟安裝 Xcode MCP 服務器：

克隆倉庫

git clone https://github.com/yourusername/xcode-mcp-server.git
cd xcode-mcp-server

安裝依賴
```
npm install
```
啟動服務器
```
npm start
```

默認情況下，服務器將在 localhost:3000 上運行。

📚 詳細文檔

配置指南

配置允許目錄

在項目根目錄下創建一個 .env 文件：

ALLOWED_DIRS=/path/to/your/project/directory

配置日誌級別

編輯 src/server.ts 文件，設置日誌級別：

const logger = Logger({
  level: 'info', // 可選值：'debug'、'info'、'warn'、'error'
})

安全指南

路徑驗證

所有文件操作都會限制在允許的目錄內：

const path = await validatePathAgainstAllowedDirs(filePath);

錯誤處理

工具執行時會捕獲並記錄錯誤信息：

try {
  // 執行工具邏輯
} catch (error) {
  logger.error(error.message);
}

高級主題

自定義工具分類

在 src/tools/ 目錄下創建新的子目錄，並在對應的 index.ts 文件中註冊工具：

// src/tools/custom/index.ts
export const customTool = new Tool({
  name: 'custom',
  description: 'Custom Xcode operation.',
  parameters: {
    // 定義參數 schema
  },
})

擴展日誌記錄

自定義日誌格式和輸出：

const logger = Logger({
  format: ({ level, message }: { level: string; message: string }) =>
    `${new Date().toISOString()} [${level.toUpperCase()}] ${message}`,
});