XcodeBuildMCP

社区

面向 iOS 与 macOS 开发的 Xcode MCP 工具服务器

分类: 开发工具第 243 / 438
Stars: ★ 6.5k 非常热门
传输方式: stdio（本地进程）
运行环境: Node.js 18+ · 预编译二进制
凭据: 无需凭据
许可证: MIT
最近提交: 33 天前

51FMRS · D

依据仓库描述、服务器清单和 README，XcodeBuildMCP 提供 stdio MCP 服务器及 CLI，重点覆盖 Xcode 项目、模拟器和应用开发流程。源材料未列出具体工具标识符，因此工具列表留空；也未提供可直接复用的客户端 JSON 配置。

最强项 · 维护活跃度 12/20 最弱项 · 可靠性 8/20

可靠性

8/20

安全与权限

9/20

维护活跃度

12/20

文档质量

11/20

安装易用性

11/20

查看各项评分依据

可靠性 8/20: 清单明确声明 npm、stdio 传输和版本，README 也给出了启动与 CLI 示例，因此正常路径是可信的。但仅凭提供的材料无法验证 MCP 初始化、工具列表握手、实际工具一致性、错误处理或依赖失败行为；CI 徽章不是可审查的执行证据。静态审查据此扣分，并将分数控制在 12 分以下。
安全与权限 9/20: 材料披露了 Sentry 运行时错误遥测及禁用变量，也说明设备工具涉及代码签名；工具主要面向本机 Xcode、模拟器和项目操作。未提供权限模型、数据边界、网络数据流、危险操作确认机制或凭据处理的源代码证据，因此无法确认最小权限和副作用控制。未发现材料明确显示的红线风险，但证据不足导致明显扣分。
维护活跃度 12/20: 仓库未归档，提供了 MIT 许可证、版本号 2.7.0、GitHub 来源、CI 徽章及 Sentry 维护归属线索，显示项目具备持续维护迹象。材料没有提交历史、发布频率、依赖更新策略、漏洞响应渠道或维护承诺，因此不能给予高分。
文档质量 11/20: README 覆盖安装方式、运行要求、客户端连接方向、CLI 示例、技能、隐私遥测、设备签名和文档入口，基础可用性较好。未提供工具完整参数、限制、失败场景、成本影响或所链接文档的内容；README 和清单本身也不能替代可复核的实现证据，因此扣分。
安装易用性 11/20: 提供 Homebrew、npm、npx 和全局 CLI 路径，并列出 macOS、Xcode、Node.js 要求，且提及主流 MCP 客户端配置。连接配置实际依赖外部文档，平台限制为 macOS/Xcode 环境；没有源文件中的端到端连接验证或测试证据，所以评为中等而非高分。

静态评测 · 未实际运行收录于 2026-07-29

查看 FMRS 评分方法 →

选型与风险

能访问什么读取本地文件写入 / 删除本地文件执行命令或代码访问网络

适合谁

使用 macOS 和 Xcode 进行 iOS 或 macOS 开发的团队
希望让 AI 编码代理参与 Xcode 项目工作流的开发者
需要 MCP 服务器与统一 CLI 的用户

不适合谁

不使用 macOS 或 Xcode 的开发环境
需要 Windows 或 Linux 原生支持的用户
不希望授予本地 Xcode、模拟器或项目操作权限的用户

所需权限

需要在 macOS 上访问 Xcode 及其项目工作流
设备工具需要在 Xcode 中配置代码签名
运行时错误遥测会发送至 Sentry；可通过 XCODEBUILDMCP_SENTRY_DISABLED 停用

风险与副作用

设备操作可能因代码签名未配置而失败
服务器请求 xcodebuild 跳过宏验证，使用 Swift Macro 项目时应了解这一构建行为
默认启用 Sentry 内部运行时错误遥测
启用实验性的增量构建功能可能带来不稳定性

安装接入

准备工作

运行环境：Node.js 18+ · 预编译二进制

其他可选配置项（4 个）

INCREMENTAL_BUILDS_ENABLED 可选布尔值，启用实验性的 xcodemake 增量构建，默认关闭。

XCODEBUILDMCP_ENABLED_WORKFLOWS 可选逗号分隔的工作流列表，控制启动时加载哪些工具集（如 simulator,device,project-discovery），留空加载默认全部。

XCODEBUILDMCP_SENTRY_DISABLED 可选布尔值，设为 true 可禁用内置的 Sentry 错误上报。

XCODEBUILDMCP_DEBUG 可选布尔值，设为 true 可启用服务器的详细调试日志。

要求 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 验证安装。

验证是否装好

运行 `xcodebuildmcp --help` 确认 CLI 安装成功，或在 MCP 客户端中通过 `npx -y xcodebuildmcp@latest mcp` 启动服务器，检查客户端工具列表中是否出现 XcodeBuildMCP 提供的工具。

常见排障

确认系统为 macOS 14.5 或更高版本、Xcode 为 16.x 或更高版本
确认 Node.js 为 18+，除非使用 Homebrew 安装
运行 xcodebuildmcp --help 验证安装是否可用
设备工具失败时检查 Xcode 中的代码签名配置
使用 XCODEBUILDMCP_DEBUG=true 启用详细调试日志
检查官方安装、配置、CLI 和故障排除文档

试试这样问

连接成功后，可以直接对 AI 助手这样说：

用 xcodebuildmcp 为模拟器构建 MyApp scheme，项目路径是 ./MyApp.xcodeproj
列出我机器上可用的 iOS 模拟器
为测试构建 MyApp 并把测试产品输出到 ./MyApp.xctestproducts
在 iPhone 17 模拟器上运行之前准备好的测试产品

使用场景

通过 MCP 让代理协助管理 Xcode 项目

构建和测试 iOS 或 macOS 模拟器目标

管理模拟器及相关开发流程

通过 CLI 直接执行项目构建、测试和工具操作

支持客户端

Cursor部分支持

Claude Code部分支持

Codex部分支持

依据项目文档列出，未经本站实测。

详细介绍

XcodeBuildMCP 是一个 MCP 服务器和命令行工具，为代理处理 iOS 与 macOS 项目提供 Xcode 项目管理、模拟器管理和应用实用工具。它同时支持 MCP 服务器模式与直接终端操作。