XcodeBuildMCP — Xcode Build Tools for Agents

简介

适合谁：希望让 AI 代理跑可复现构建，并用真实日志定位 Xcode 问题的 iOS/macOS 团队

适用环境：macOS 14.5+、Xcode 16.x、Node.js 18+（npm 路径）或 Homebrew；支持 MCP 的客户端

安装耗时：10 分钟

量化信息

• 要求 macOS 14.5+ 与 Xcode 16.x（仓库）
• 装机约 10 分钟

用好它的方式

把 Xcode 构建当成数据管道：构建 → 抓日志 → 提取精确失败命令与环境 → 修复 → 验证。MCP 工具链能让 agent 保持 grounded。

推广清单

• 先选一个真实任务，小范围试跑
• 记录基线：首次成功耗时与输出质量
• 配置/技能要版本化，避免团队漂移

风险与护栏

对签名与设备要求要写清楚：很多失败来自环境/配置，而不是代码逻辑。

FAQ

Q: 用 Homebrew 还需要 npm 吗？ A: 不需要。仓库同时提供 Homebrew 与 npm 两种安装方式；任意一种都包含 CLI 与 MCP server。

Q: MCP 客户端怎么运行？ A: 多数客户端可通过命令启动 MCP server；仓库提供配置片段，并提到 npx -y xcodebuildmcp@latest mcp。

Q: 第一步做什么最合适？ A: 先对一个已知 scheme 做 simulator build，再让 agent 总结 warning 与失败环节，并把关键信息写成可复现清单。