XcodeBuildMCP

一个模型上下文协议（MCP）服务器和命令行工具，为代理在iOS和macOS项目开发中提供工具支持。

GitHub

6.2k

你可以用 Xcode Build MCP 做什么？

构建模拟器应用 — 让代理使用方案和项目路径运行 simulator build，以编译您的 iOS 或 macOS 项目。
在特定模拟器上运行测试 — 使用 simulator test 配合测试产品路径和模拟器名称，执行预先准备好的测试包。
准备测试产品但不运行 — 调用带 --build-for-testing 和 --test-products-path 参数的 simulator build，生成可移植的 .xctestproducts 包。
为 AI 客户端启动 MCP 服务器 — 运行 mcp 子命令，使您的编码代理能通过 MCP 协议访问所有构建和测试工具。
从命令行列出可用工具 — 使用 tools 命令发现当前环境中可用的操作。
检查并应用更新 — 运行 upgrade --check 或 upgrade --yes 就地更新 CLI。

文档

一个模型上下文协议（MCP）服务器和命令行工具，为处理 iOS 和 macOS 项目的智能体提供工具。

安装

XcodeBuildMCP 以单一软件包形式发布，提供两种模式：用于直接终端使用的 CLI 和用于 AI 编码智能体的 MCP 服务器。任一安装方式均可同时获得两者。

选项 A — Homebrew

brew tap getsentry/xcodebuildmcp
brew install xcodebuildmcp

选项 B — npm（Node.js 18+）

npm install -g xcodebuildmcp@latest

验证安装：

xcodebuildmcp --help

连接你的 MCP 客户端

适用于 Cursor、Claude Code、Codex 的即用型配置片段，可在官方文档页面 MCP 客户端中找到。大多数客户端还可以通过 npx -y xcodebuildmcp@latest mcp 按需运行 MCP 服务器，无需全局安装。

要求

macOS 14.5 或更高版本
Xcode 16.x 或更高版本
Node.js 18.x 或更高版本（Homebrew 安装则不需要）

技能

XcodeBuildMCP 现在包含两个可选的智能体技能：

MCP 技能：为智能体提供如何使用 MCP 服务器工具的指导（使用 MCP 服务器时可选）。
CLI 技能：为智能体提供如何操作 CLI 的指导（使用 CLI 时推荐）。

使用全局二进制文件安装：

xcodebuildmcp init

或通过 npx 直接安装，无需全局安装：

npx -y xcodebuildmcp@latest init

有关安装技能的更多信息，请参阅智能体技能。

注意事项

XcodeBuildMCP 请求 xcodebuild 跳过宏验证，以避免在构建使用 Swift 宏的项目时出现错误。
设备工具需要在 Xcode 中配置代码签名。请参阅设备代码签名。

隐私

XcodeBuildMCP 仅使用 Sentry 进行内部运行时错误遥测。有关详细信息和退出说明，请参阅隐私与遥测。

CLI

XcodeBuildMCP 提供统一的命令行界面。mcp 子命令启动 MCP 服务器，而所有其他命令提供对工具的直接终端访问：

# Install globally
npm install -g xcodebuildmcp@latest

# Start the MCP server (for MCP clients)
xcodebuildmcp mcp

# List available tools
xcodebuildmcp tools

# Build for simulator
xcodebuildmcp simulator build --scheme MyApp --project-path ./MyApp.xcodeproj

# Prepare portable test products without running tests
xcodebuildmcp simulator build --scheme MyApp --project-path ./MyApp.xcodeproj --simulator-name "iPhone 17" --build-for-testing --test-products-path ./MyApp.xctestproducts

# Run previously prepared test products
xcodebuildmcp simulator test --test-products-path ./MyApp.xctestproducts --simulator-name "iPhone 17"

检查更新并就地升级：

xcodebuildmcp upgrade --check
xcodebuildmcp upgrade --yes

CLI 使用按工作区划分的守护进程来处理有状态操作（日志捕获、调试等），该守护进程会在需要时自动启动。完整文档请参阅 CLI 指南。

文档

安装：https://xcodebuildmcp.com/docs/installation
设置：https://xcodebuildmcp.com/docs/setup
MCP 客户端：https://xcodebuildmcp.com/docs/clients
CLI 用法：https://xcodebuildmcp.com/docs/cli
配置与选项：https://xcodebuildmcp.com/docs/configuration
工具参考：https://xcodebuildmcp.com/docs/tools
故障排除：https://xcodebuildmcp.com/docs/troubleshooting
隐私：https://xcodebuildmcp.com/docs/privacy
技能：https://xcodebuildmcp.com/docs/skills
贡献：https://xcodebuildmcp.com/docs/contributing

许可证

本项目基于 MIT 许可证授权 - 详情请参阅 LICENSE 文件。有关第三方许可声明，请参阅 THIRD_PARTY_LICENSES 文件。有关 npm 软件包归属，请参阅 THIRD_PARTY_PACKAGE_LICENSES 文件。