适合谁
- 使用 macOS 和 Xcode 进行 iOS 或 macOS 开发的团队
- 希望让 AI 编码代理参与 Xcode 项目工作流的开发者
- 需要 MCP 服务器与统一 CLI 的用户
X
51FMRS · D
依据仓库描述、服务器清单和 README，XcodeBuildMCP 提供 stdio MCP 服务器及 CLI，重点覆盖 Xcode 项目、模拟器和应用开发流程。源材料未列出具体工具标识符，因此工具列表留空；也未提供可直接复用的客户端 JSON 配置。
XcodeBuildMCP 是一个 MCP 服务器和命令行工具，为代理处理 iOS 与 macOS 项目提供 Xcode 项目管理、模拟器管理和应用实用工具。它同时支持 MCP 服务器模式与直接终端操作。
工具能力
暂未整理工具清单。
安装接入
要求 macOS 14.5 或更高版本，以及 Xcode 16.x 或更高版本。使用 Homebrew：brew tap getsentry/xcodebuildmcp && brew install xcodebuildmcp；或使用 Node.js 18+：npm install -g xcodebuildmcp@latest。启动 MCP 服务器：xcodebuildmcp mcp；也可按需运行 npx -y xcodebuildmcp@latest mcp。使用 xcodebuildmcp --help 验证安装。
选型与风险
不适合谁
- 不使用 macOS 或 Xcode 的开发环境
- 需要 Windows 或 Linux 原生支持的用户
- 不希望授予本地 Xcode、模拟器或项目操作权限的用户
所需权限
- 需要在 macOS 上访问 Xcode 及其项目工作流
- 设备工具需要在 Xcode 中配置代码签名
- 运行时错误遥测会发送至 Sentry；可通过 XCODEBUILDMCP_SENTRY_DISABLED 停用
风险与副作用
- 设备操作可能因代码签名未配置而失败
- 服务器请求 xcodebuild 跳过宏验证，使用 Swift Macro 项目时应了解这一构建行为
- 默认启用 Sentry 内部运行时错误遥测
- 启用实验性的增量构建功能可能带来不稳定性
常见排障
- 确认系统为 macOS 14.5 或更高版本、Xcode 为 16.x 或更高版本
- 确认 Node.js 为 18+，除非使用 Homebrew 安装
- 运行 xcodebuildmcp --help 验证安装是否可用
- 设备工具失败时检查 Xcode 中的代码签名配置
- 使用 XCODEBUILDMCP_DEBUG=true 启用详细调试日志
- 检查官方安装、配置、CLI 和故障排除文档
使用场景
通过 MCP 让代理协助管理 Xcode 项目
构建和测试 iOS 或 macOS 模拟器目标
管理模拟器及相关开发流程
通过 CLI 直接执行项目构建、测试和工具操作
支持客户端
Cursor部分支持
Claude Code部分支持
Codex部分支持