Xcodeproj MCP Server

🚀 xcodeproj-mcp-server

xcodeproj-mcp-server 是一個基於 Swift 語言的 Model Context Protocol (MCP) 服務器，主要用於對 Xcode 項目文件（.xcodeproj）進行編程式操作。它能讓 AI 助手和其他 MCP 客戶端輕鬆創建、管理和修改 Xcode 項目。

🚀 快速開始

準備工作

• macOS 14.0 或更高版本
• Xcode 16.4 或更高版本

安裝步驟

首先，克隆倉庫並以發佈模式構建項目：

git clone https://github.com/giginet/xcodeproj-mcp-server.git
cd xcodeproj-mcp-server
swift build -c release

針對 Claude Desktop 的配置

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

{
  "mcpServers": {
    "xcodeproj": {
      "command": "/path/to/xcodeproj-mcp-server/.build/release/xcodeproj-mcp-server"
    }
  }
}

請將 /path/to/xcodeproj-mcp-server 替換為你克隆倉庫的實際路徑。

針對 Claude Code 的配置

# 使用本地可執行文件添加 MCP 服務器
$ claude mcp add --name xcodeproj --command "/path/to/xcodeproj-mcp-server/.build/release/xcodeproj-mcp-server"

同樣，請將 /path/to/xcodeproj-mcp-server 替換為你克隆倉庫的實際路徑。

✨ 主要特性

• 項目管理：創建新的 Xcode 項目，管理目標、文件和構建配置。
• 文件操作：添加、移除、移動或重命名項目中的文件。
• 目標管理：創建、移除、複製目標，並添加目標之間的依賴關係。
• 構建配置：獲取和修改構建設置，添加框架依賴和自定義構建階段。
• 實用工具：在 Xcode 中打開項目。

💻 使用示例

項目管理

• create_xcodeproj - 創建新的 Xcode 項目
  • 參數：project_name、path、organization_name、bundle_identifier
• list_targets - 列出項目中的所有目標
  • 參數：project_path

文件操作

• add_file - 向項目中添加文件
  • 參數：project_path、file_path、target_name、group_path
• remove_file - 從項目中移除文件
  • 參數：project_path、file_path

目標管理

• add_target - 創建新目標
  • 參數：project_path、target_name、type、platform、bundle_identifier
• remove_target - 移除現有目標
  • 參數：project_path、target_name

構建配置

• get_build_settings - 獲取目標的構建設置
  • 參數：project_path、target_name、configuration_name
• set_build_setting - 修改構建設置
  • 參數：project_path、target_name、setting_name、value、configuration_name

實用工具

• open_xcodeproj - 在 Xcode 中打開 Xcode 項目
  • 參數：project_path、wait（可選）

📚 詳細文檔

xcodeproj-mcp-server 是一個 MCP 服務器，它提供了以編程方式操作 Xcode 項目文件的工具。它利用 tuist/xcodeproj 庫進行可靠的項目文件操作，並使用 swift-sdk 實現了 Model Context Protocol。

此服務器使 AI 助手和其他 MCP 客戶端能夠：

• 創建新的 Xcode 項目
• 管理目標、文件和構建配置
• 修改構建設置
• 添加依賴項和框架
• 自動化常見的 Xcode 項目任務

📄 許可證

本項目採用 MIT 許可證。

⚠️ 重要提示

本產品處於開發階段，即將發佈。