使用说明

项目简介

这个项目是一个Model Context Protocol (MCP) 服务器，专门用于通过程序化方式操作和管理Xcode项目文件（'.xcodeproj'）。它利用了优秀的'tuist/xcodeproj'库来确保对项目文件的可靠修改，并使用'modelcontextprotocol/swift-sdk'库实现了MCP协议。通过这个服务器，AI助手或其他MCP客户端可以获取Xcode项目的信息并执行各种修改操作。

主要功能点

这个服务器提供了丰富的工具集，允许MCP客户端对Xcode项目进行精细控制：

项目管理: 创建、打开、列出项目中的目标、构建配置、文件等。
文件操作: 向项目添加/移除文件，移动/重命名文件，创建组等。
目标管理: 添加/移除/复制目标，管理目标间的依赖。
构建配置: 获取/设置目标的构建设置，添加框架依赖，添加自定义构建阶段。
实用功能: 通过系统命令打开项目文件。

安装步骤

要使用这个MCP服务器，你需要先将其构建出来。

首先，通过Git克隆项目仓库到你的本地机器：

git clone https://github.com/giginet/xcodeproj-mcp-server.git
cd xcodeproj-mcp-server

然后，在项目目录下使用Swift Package Manager构建Release模式的可执行文件：
```
swift build -c release
```
构建成功后，可执行文件会生成在 '.build/release/' 目录下，文件名为 'xcodeproj-mcp-server'。

服务器配置

MCP服务器通常由MCP客户端负责启动和管理。你需要将这个服务器添加到你使用的MCP客户端的配置中，以便客户端知道如何找到并运行它。

一般来说，MCP客户端的配置会有一个部分用于定义MCP服务器。你需要为这个服务器指定一个易于识别的名称（例如 'xcodeproj'），然后提供你刚刚构建好的服务器可执行文件的完整路径作为客户端配置中的 'command' 参数的值。例如：

如果你使用Claude Desktop，你需要编辑其配置文件（通常位于 '~/Library/Application Support/Claude/claude_desktop_config.json'），在 '"mcpServers"' 部分添加一个新的条目，其中包含 'command' 字段，并指向你构建好的 '/path/to/xcodeproj-mcp-server/.build/release/xcodeproj-mcp-server' 路径。
如果你使用Claude Code命令行工具，可以使用类似的命令 'claude mcp add --name xcodeproj --command "/path/to/xcodeproj-mcp-server/.build/release/xcodeproj-mcp-server"' 进行配置。

请务必将示例中的 '/path/to/xcodeproj-mcp-server' 替换为你实际克隆并构建项目的路径。

基本使用方法

一旦MCP客户端配置并成功启动了 'xcodeproj-mcp-server'，AI助手就可以通过MCP协议与其建立通信。AI助手会发现服务器提供的所有可用工具（例如 'create_xcodeproj', 'add_target', 'set_build_setting' 等）。你可以通过与AI助手交互，指示它调用这些工具来完成对Xcode项目的自动化操作，例如让AI“创建一个名为MyApp的Swift应用程序项目”或“给目标MyApp添加一个运行脚本构建阶段”。具体的交互方式取决于你使用的MCP客户端界面。

关键词