XcodeBuildMCP

一个模型上下文协议 (MCP) 服务器和 CLI，为智能体在处理 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 Clients 中找到。大多数客户端也可以通过 npx -y xcodebuildmcp@latest mcp 按需运行 MCP 服务器，无需全局安装。

Related MCP server: MCP Xcode Server

要求

• 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

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

注意事项

• XcodeBuildMCP 要求 xcodebuild 跳过宏验证，以避免在构建使用 Swift Macros 的项目时出现错误。

• 设备工具需要 Xcode 中配置代码签名。请参阅 Device Code Signing。

隐私

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

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

检查更新并就地升级：

xcodebuildmcp upgrade --check
xcodebuildmcp upgrade --yes

CLI 使用每个工作区的守护进程进行状态操作（日志捕获、调试等），该进程在需要时会自动启动。有关完整文档，请参阅 CLI guide。

文档

• 安装：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 文件以获取详细信息。