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 许可证。

⚠️ 重要提示

本产品处于开发阶段，即将发布。