AgentMatter
EN/中文
提交项目GitHub
MCP 服务器 · 发布者仓库

XcodeBuildMCP

把 Xcode 构建、测试、模拟器、真机、调试和 UI 自动化工具接入支持 MCP 的编码 Agent，并提供独立 CLI。

6.3k StarsMITTypeScript1 个月前更新
安装与使用 GitHub
01

项目介绍

XcodeBuildMCP 是面向 Apple 平台开发的本地 MCP 服务器和 CLI。它把 Xcode 工程发现、构建与测试、模拟器和真机控制、LLDB 调试、日志采集、UI 自动化等能力交给编码 Agent。这个项目不只是封装一条 xcodebuild 命令，仓库里有 82 个工具清单，并按 15 个工作流组织，团队可以只启用当前任务需要的能力。它适合让 Agent 接触真实 Xcode 工具链，而不只根据源码猜测构建和运行状态。

02

核心功能

01

跨 Apple 目标构建与测试

模拟器、真机和 macOS 工作流提供构建、运行、测试、清理、定位应用产物和复用已准备测试的操作。真机仍依赖 Xcode 中正确的代码签名。

02

模拟器与应用控制

工具清单覆盖列出、启动、打开和关闭模拟器，以及安装、启动、停止应用和收集日志。

03

UI 自动化与可访问性检查

Agent 可以获取截图和可访问性层级，并在受支持的模拟器上执行点击、滑动、输入、按键和手势。

04

LLDB 与 Xcode 诊断

调试和 Xcode IDE 工作流提供调试会话、断点、执行控制、诊断信息和部分 IDE 驱动操作。

05

按工作流限制工具暴露

配置可以启用内置或自定义工作流，从而限制 Agent 能看到的工具。README 说明默认只启用 simulator 工作流。

03

安装与连接

选择 Homebrew 二进制或 npm 包，把 stdio 启动命令加入 MCP 宿主，先验证发现能力，再按任务逐步开放更多工作流。

AI AGENT INSTALL

让 AI Agent 帮你安装

把这段话发送给 Codex、Claude Code 或其他可以操作本地环境的 AI Agent。

请帮我从 https://github.com/getsentry/XcodeBuildMCP 安装并配置 XcodeBuildMCP。先阅读 README、发布说明、LICENSE、SECURITY 和配置示例，确认 macOS 与 Xcode 版本。除非我明确需要 npm，否则优先使用 Homebrew。写入前先展示 MCP 配置，初次只启用最小工作流；如果我的政策要求，请关闭 Sentry 遥测。不要擅自构建项目、控制设备、删除 DerivedData 或覆盖配置。用帮助命令或只读发现能力验证连接，并汇报改动文件、命令和结果。
01开始前准备
  • macOS 14.5 或更新版本
  • Xcode 16.x 或更新版本
  • 使用 npm 或 npx 时需要 Node.js 18 或更新版本
  • 支持 MCP stdio 配置的宿主
  • 使用真机工具前先在 Xcode 中完成代码签名配置
02复制安装命令或配置
{"mcpServers":{"XcodeBuildMCP":{"command":"xcodebuildmcp","args":["mcp"]}}}
03按步骤完成安装
  1. 1
    确认本机工具链

    检查 macOS 是否满足要求，并确认已安装 Xcode 16.x 或更新版本。涉及真机前，先在 Xcode 中完成代码签名。

  2. 2
    选择安装方式

    Homebrew 方式先运行 `brew tap getsentry/xcodebuildmcp`，再运行 `brew install xcodebuildmcp`。npm 方式要求 Node.js 18 或更新版本，文档给出的启动命令是 `npx -y xcodebuildmcp@latest mcp`。

  3. 3
    写入 stdio MCP 配置

    让宿主运行 `xcodebuildmcp mcp`；如果采用 npx，则命令为 `npx`，参数依次为 `-y`、`xcodebuildmcp@latest`、`mcp`。同时决定是否关闭 Sentry 运行错误诊断。

  4. 4
    先验证再扩大权限

    重启宿主，确认服务器和工具出现。先运行帮助、工程发现或列出模拟器，只在任务确实需要时启用更多工作流。

如何确认安装成功

重启 MCP 宿主并确认 XcodeBuildMCP 连接成功。先执行 `xcodebuildmcp --help` 或工程发现，再选择无敏感数据的示例项目列出 Scheme 或模拟器，确认输出正常后才进行构建或 UI 操作。

使用前注意
  • Homebrew 方式不需要 Node.js
  • 默认只启用 simulator 工作流
  • 可用 XCODEBUILDMCP_SENTRY_DISABLED=true 或 sentryDisabled: true 关闭遥测
  • 升级现有接入前要检查 v2.7.0 的 schema 和 configuration 行为变化
04

使用场景

SCENARIO 01

构建并测试一项 iOS 改动

Agent 可以发现工程和 Scheme、选择模拟器、构建应用、运行测试并读取结构化结果，不必由用户逐条翻译 xcodebuild 参数。

SCENARIO 02

复现模拟器 UI 故障

UI 自动化工具可以查看可访问性状态、获取截图、执行手势并采集日志，让 Agent 按固定路径复现问题。

SCENARIO 03

调试 macOS 或真机进程

启用相应工作流并授予本机权限后，Agent 可以启动目标、连接 LLDB、管理断点并检查执行状态。

SCENARIO 04

在自动化中复用测试产物

v2.7.0 可以生成可移植的 `.xctestproducts`，以后无需重新构建即可运行，同时仍生成新的 `.xcresult`。

05

使用评价

XcodeBuildMCP 对 Apple 平台 Agent 工作流的覆盖很完整，也有较好的可检查性。工具、工作流边界、配置、测试、更新记录、发布说明和安全报告入口都在公开仓库中。Homebrew 安装不依赖 Node.js，自定义工作流还能缩小暴露给 Agent 的工具面。代价也很明确，它会获得构建、进程、模拟器、真机和 UI 输入等本机能力。团队还要处理默认 Sentry 运行错误诊断，以及 v2.7.0 的 schema v3 破坏性变化。本次收录没有安装或执行项目。

值得一试的地方

  • 用明确的工作流清单组织了较完整的 Xcode 能力
  • Homebrew、npm、MCP、CLI、配置和升级路径都有文档
  • 近期仍有发布和提交，并提供公开测试与安全说明
  • 可以通过工作流选择缩小 Agent 看到的工具范围

使用前要知道

  • 必须有兼容的 macOS 与 Xcode 工具链
  • Agent 操作可能影响构建、模拟器、应用、进程和本地文件
  • 除非显式关闭，否则默认发送运行错误遥测
  • 现有结构化输出消费者可能要为 v2.7.0 schema v3 做适配
06

README

XcodeBuildMCP

Overview

把 Xcode 构建、测试、模拟器、真机、调试和 UI 自动化工具接入支持 MCP 的编码 Agent，并提供独立 CLI。 为 Xcode 提供 MCP 服务器与 CLI 工具，让 Agent 能参与 iOS 和 macOS 开发流程。

Getting started

  • 选择 Homebrew 二进制或 npm 包，把 stdio 启动命令加入 MCP 宿主，先验证发现能力，再按任务逐步开放更多工作流。
  • 仓库同时提供 MCP 服务器和独立 CLI。MCP 宿主可以启动 Homebrew 安装的二进制，也可以运行 `npx -y xcodebuildmcp@latest mcp`；CLI 则把同一批工具暴露为可发现的命令。
  • 15 个工作流覆盖模拟器和真机构建、macOS 应用、工程发现与脚手架、Swift Package、UI 自动化、LLDB 调试、Xcode IDE 集成、覆盖率、诊断、通用工具和会话管理。随包提供的 Skill 建议先设定会话默认值，并只启用当前任务需要的工作流。
  • 重启 MCP 宿主并确认 XcodeBuildMCP 连接成功。先执行 `xcodebuildmcp --help` 或工程发现，再选择无敏感数据的示例项目列出 Scheme 或模拟器，确认输出正常后才进行构建或 UI 操作。

Configuration

{"mcpServers":{"XcodeBuildMCP":{"command":"xcodebuildmcp","args":["mcp"]}}}
在 GitHub 阅读完整 README →