Xcode Build MCP

XcodeBuildMCP 是一款专为 AI 助手和开发工具设计的服务器工具，通过标准化接口与 Xcode 项目、iOS/macOS 模拟器和应用进行交互。它支持项目管理、模拟器控制、应用调试和 UI 自动化等功能，帮助开发者实现自动化构建、测试和问题修复，显著提升开发效率。

核心功能

XcodeBuildMCP 提供了多个核心功能模块，涵盖 Xcode 项目管理、模拟器控制、应用工具和 UI 自动化（Beta）。

• Xcode 项目管理：支持发现、构建和清理 Xcode 项目，获取项目信息如构建配置和方案。
• 模拟器管理：可列出、启动和控制 iOS 模拟器，安装和调试应用，并捕获日志。
• 应用工具：提取应用的 Bundle Identifier，支持在模拟器和 macOS 设备上启动应用。
• UI 自动化（Beta）：通过点击、滑动等操作与模拟器 UI 交互，并支持截图获取视觉反馈。

安装方法

安装 XcodeBuildMCP 需要 macOS 14.5+ 和 Xcode 18+ 环境，并使用 mise 工具进行安装。

brew install mise

mise x npm:xcodebuildmcp@1.3.1

此外，还可以通过 npm 全局安装：

npm install -g xcodebuildmcp@1.3.1

如果需要使用 UI 自动化功能，还需安装 idb-companion：

brew install idb-companion

使用方法

安装完成后，需在 AI 客户端（如 Cursor 或 Claude Code）中配置 XcodeBuildMCP 服务器。

{
  "mcpServers": {
    "XcodeBuildMCP": {
      "command": "mise",
      "args": ["x", "npm:xcodebuildmcp@1.3.1", "--", "xcodebuildmcp"]
    }
  }
}

配置完成后，AI 客户端即可通过 XcodeBuildMCP 执行以下操作：

• 构建 Xcode 项目
• 在模拟器上运行应用
• 捕获日志和截图
• 自动修复构建错误

使用示例

以下是一些典型使用场景和代码示例：

xcodebuildmcp-diagnostic

该命令用于运行诊断工具，检查系统配置和依赖项状态。

Fix the compilation errors in this Xcode project

AI 客户端可自动识别并修复项目中的编译错误。

Tap the login button in the simulator and show me the result

通过 UI 自动化功能，AI 可以模拟点击登录按钮并返回截图。

Build and run this iOS app on an iPhone 15 simulator

AI 可以完成从构建到运行的完整流程，并提供日志输出。

注意事项

使用 XcodeBuildMCP 时需注意以下事项：

• 默认启用跳过 Swift 宏验证的选项，以避免在使用 Swift Macros 的项目中出现错误。
• UI 自动化功能目前处于 Beta 阶段，部分功能可能不稳定。
• 建议使用 xcodebuildmcp-diagnostic 工具进行系统和依赖项检查。

XcodeBuildMCP 通过标准化接口和自动化能力，为 AI 助手和开发工具提供了强大的 Xcode 项目管理与调试支持，是现代开发流程中不可或缺的工具。