Xcode MCP 服务器

“Xcode” MCP 服务器能做什么？

Xcode MCP（模型上下文协议）服务器是一款专为将 AI 助手与 Xcode 开发环境无缝连接而设计的工具。它通过标准协议开放丰富的 Xcode 相关操作，使 AI 智能体能够管理 Xcode 项目、自动处理文件、控制 iOS 模拟器，并与各种项目依赖和构建工具交互。这种深入集成极大地简化了开发流程，使诸如构建、测试、代码分析、依赖管理（CocoaPods 和 Swift 包管理器）及模拟器控制等任务，可以通过程序或智能助手自动完成。对于自动化重复性任务、提升代码质量、加速 iOS/macOS 项目开发而言，该服务器价值极高，让强大的 Xcode 功能通过自然语言或 AI 驱动界面变得易于访问。

提示模板列表

在可用仓库文件或文档中未提及任何提示模板。

资源列表

在可用仓库文件或文档中未列出任何明确的 MCP 资源。

工具列表

• 项目管理工具

  • 设置活动项目并获取项目信息。
  • 基于模版（如 iOS、macOS）新建 Xcode 项目。
  • 向项目添加文件并指定目标或分组。
  • 解析工作区文档并列出 scheme。

• 文件操作

  • 读取和写入文件（支持编码）。
  • 通过 base64 处理二进制文件。
  • 使用模式/正则查找文本。
  • 检查文件存在性及元数据。
  • 自动创建目录。

• 构建与测试

  • 自定义参数构建项目。
  • 运行测试并报告失败。
  • 代码分析。
  • 清理构建目录。
  • 项目归档用于分发。

• CocoaPods 集成

  • 初始化、安装、更新和管理 pods。
  • 添加/移除 pod 依赖。
  • 执行任意 pod 命令。

• Swift 包管理器

  • 管理 Swift 包及依赖。
  • 更新/解析包。
  • 生成文档。
  • 构建与测试包。

• iOS 模拟器工具

  • 列出、启动、关闭模拟器。
  • 安装和启动应用。
  • 截图/录制视频。
  • 管理模拟器设置。

• Xcode 实用工具

  • 通过 xcrun 执行 Xcode 命令。
  • 编译资源目录。
  • 生成 App 图标集。
  • 跟踪应用性能。
  • 导出/验证归档以提交 App Store。
  • 切换 Xcode 版本。

典型应用场景

• 自动化项目搭建
  AI 智能体可快速创建并配置新 Xcode 项目，设置 CocoaPods 或 Swift 包管理器等依赖管理工具，准备目录结构，大幅减少项目初始化的人力投入。

• 持续集成与测试
  自动化 iOS/macOS 项目的构建、测试和分析流程。AI 驱动例程可触发构建、执行测试并报告失败或代码问题，通过聊天或脚本接口支撑强大的 CI/CD 流水线。

• 模拟器管理与测试
  通过编程方式控制 iOS 模拟器，实现自动化 UI 测试、应用安装、截图/录屏等，提升移动端测试的覆盖面与可靠性。

• 依赖管理
  通过 CocoaPods 或 Swift 包管理器自动化三方库的添加、移除和更新，保证项目始终保持最新和兼容，减少人工干预。

• 资源与构建工具
  自动化资源编译、图标生成及构建产物管理（包括归档和 App Store 导出），提升效率并降低人为失误风险。

如何设置

Windsurf

1. 确保已安装 macOS、Xcode（14.0+）、Node.js（16+）和 npm。
2. 下载或克隆 xcode-mcp-server 仓库。
3. 运行安装脚本：

   chmod +x setup.sh
   ./setup.sh
   

4. 编辑 Windsurf 配置文件以添加 MCP 服务器：

   {
     "mcpServers": {
       "xcode-mcp": {
         "command": "npx",
         "args": ["@xcode/mcp-server@latest"]
       }
     }
   }
   

5. 保存配置并重启 Windsurf，通过检查 Xcode MCP 工具可用性进行验证。

Claude

1. 安装前置环境（macOS、Xcode、Node.js、npm）。
2. 克隆仓库并按上述方式运行安装脚本。
3. 找到 Claude 的 MCP 配置文件。
4. 添加 Xcode MCP 服务器：

   {
     "mcpServers": {
       "xcode-mcp": {
         "command": "npx",
         "args": ["@xcode/mcp-server@latest"]
       }
     }
   }
   

5. 保存并重启 Claude。通过工具列表确认配置无误。

Cursor

1. 确保所有依赖已安装。
2. 克隆仓库并执行安装脚本。
3. 打开 Cursor 的 MCP 配置文件。
4. 在 mcpServers 下添加以下内容：

   {
     "mcpServers": {
       "xcode-mcp": {
         "command": "npx",
         "args": ["@xcode/mcp-server@latest"]
       }
     }
   }
   

5. 保存并重启 Cursor，验证服务器已成功激活。

Cline

1. 配置前置环境并运行安装脚本。
2. 编辑 Cline 的 MCP 服务器配置文件。
3. 插入 Xcode MCP 服务器条目：

   {
     "mcpServers": {
       "xcode-mcp": {
         "command": "npx",
         "args": ["@xcode/mcp-server@latest"]
       }
     }
   }
   

4. 保存更改并重启 Cline。
5. 确认 Xcode MCP 服务器在 Cline 内部已正常运行。

使用环境变量保护 API 密钥

• 将敏感数据（API 密钥、令牌等）放入 .env 文件。
• .env 用法示例：

  XCODE_MCP_API_KEY=your_api_key_here
  

• 在你的配置中引用环境变量：

  {
    "mcpServers": {
      "xcode-mcp": {
        "command": "npx",
        "args": ["@xcode/mcp-server@latest"],
        "env": {
          "XCODE_MCP_API_KEY": "${XCODE_MCP_API_KEY}"
        },
        "inputs": {
          "projectBaseDir": "/Users/yourname/Projects"
        }
      }
    }
  }
  

如何在 FlowHunt 流程中使用 MCP

在 FlowHunt 中集成 MCP

要将 MCP 服务器集成到你的 FlowHunt 工作流，首先将 MCP 组件添加到流程，并与 AI 智能体连接：

点击 MCP 组件以打开配置面板。在系统 MCP 配置部分，使用如下 JSON 格式填写你的 MCP 服务器信息：

{
  "xcode-mcp": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

配置完成后，AI 智能体即可作为工具使用 MCP 并访问其所有功能。请记得将 “MCP-name” 替换为你实际的 MCP 服务器名称（如 “xcode-mcp”），并将 URL 换成你的 MCP 服务器地址。

概览

结合上述信息，Xcode MCP 服务器在 Xcode 自动化方面功能完备，但缺乏关于提示模板、明确 MCP 资源和采样/根功能的文档。其项目/构建工具能力强，且有清晰的搭建说明。

MCP 评分

总体上，我给这个 MCP 服务器的评分是 7/10。
它在 Xcode 集成和自动化工具方面非常全面，搭建文档清晰，且有明确的开源协议。但缺乏提示模板、明确 MCP 资源、根和采样支持，这些对于完整 MCP 兼容和高级工作流来说同样重要。