Xcode Build MCP

模型上下文协议（MCP）服务器和CLI，在处理iOS和macOS项目时为代理提供工具。


安装

XcodeBuildMCP作为一个单独的软件包提供，有两种模式： 命令行界面 用于直接终端使用和 MCP服务器 AI编码代理。无论哪种安装方法都能同时提供这两种功能。

选项A——自制

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客户端大多数客户端还可以通过以下方式按需运行MCP服务器 npx -y xcodebuildmcp@latest 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用于内部运行时错误遥测。有关详细信息和退出说明，请参阅 隐私和遥测.

命令行界面

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指南 获取完整文档。

文档

• 安装： 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许可证获得许可-请参阅 许可证 文件以获取详细信息。 有关第三方许可通知，请参阅 第三方许可证 文件以获取详细信息。 关于npm包的属性，请参见 第三方包装许可证 文件以获取详细信息。