XcodeBuildMCP 应用构建工具

要解决的问题

在 Apple 平台的日常开发里，构建、测试和检查 Xcode 工程通常只能在 IDE 内手动完成：先选 scheme，再挑模拟器或设备，点下 Run，然后盯着测试日志翻找失败原因。当编码代理（LLM agent）开始接管代码修改工作时，这个流程就成了瓶颈——代理无法直接触发 xcodebuild，看不到构建错误，也没法确认自己的改动是否真的通过测试。

XcodeBuildMCP 要解决的就是这条断链：它把 Xcode 的构建、测试、模拟器与工程检查能力封装成可被机器调用的接口，让编码代理在不离开对话环境的情况下完成「改代码 → 构建 → 跑测试 → 看结果」的闭环。

工作方式

这个技能的核心是 XcodeBuildMCP 包，它以单一发行包提供两种使用模式：

• CLI 模式：直接在终端里调用，适合开发者自己手动触发构建或测试。
• MCP 服务器模式：挂到兼容 MCP 的客户端上，让编码代理通过标准化的工具调用协议请求构建、测试、启动模拟器和检查工程配置。

无论走哪种安装方式，两种模式都会同时可用。对代理而言，典型的工作路径是：

1. 代理通过 MCP 工具发起一次构建，拿到编译结果与错误输出。
2. 构建通过后，代理选择目标模拟器启动应用并执行测试套件。
3. 出现问题时，代理调用工程检查能力定位配置或结构层面的原因，而不是凭猜测反复改代码。

适用边界与注意点

• 需要 Xcode 16 或更高版本，环境本身必须支持构建 Apple 平台应用；纯 Linux 或 Windows 机器无法使用。
• npm 安装路线要求 Node.js 18 或更高版本；Homebrew 路线不依赖 Node 运行时。
• 需要一台兼容 MCP 的客户端才能发挥代理联动的价值，CLI 模式则对客户端没有要求。
• 上游采用 MIT 协议发布，配套文档见 https://www.xcodebuildmcp.com，遇到行为差异时应以上游文档为准。