xcodebuildmcp

XcodeBuildMCP 是一个强大的模型上下文协议 (MCP) 服务器与 CLI 工具，旨在协助 AI 代理管理 iOS、macOS、watchOS、tvOS 与 visionOS 的开发生命周期。它作为代理与 Apple 开发堆栈之间的接口，通过结构化的工具工作流程取代手动执行 xcodebuild、xcrun 与 simctl。对于需要在不离开终端或代理辅助环境的情况下，自动化复杂构建周期、执行自动化 UI 测试或在模拟器与物理设备上进行调试的开发者来说，它是理想的选择。

• 完整支持 Xcode 项目与工作区探索，包括方案列表与构建设置检查。

• 全面的模拟器管理，包括开机、清除、定位操控与应用程序生命周期控制 (安装/启动)。

• 针对物理硬件的进阶设备工作流程，涵盖构建、测试以及符合代码签名要求的部署。

• 集成 LLDB 调试器连接，使代理能够附加到处理程序、设置断点并检查变量与堆栈跟踪。

• 强大的 UI 自动化功能，包括截图捕获、基于坐标交互的视图层级检查，以及点击、滑动与文本输入等模拟动作。

• 统一支持 Swift Package Manager (SwiftPM) 项目与用于生成新应用程序模板的项目脚手架。

• 从已连接的模拟器与物理设备高效流式传输并捕获日志，以便即时进行错误诊断。

• 用户应通过会话配置定义项目、方案与目标默认值，以减少重复参数的负担。

• 代理在发起任何构建或测试动作之前，必须调用 session_show_defaults 以确保正确的上下文处于启动状态。

• 某些进阶功能 (如物理设备交互与 UI 自动化) 可能需要在 .xcodebuildmcp/config.yaml 文件中进行特定配置，才能在默认的模拟器工具集之外启用。

• 涉及 Swift Macros 的项目应使用提供的跳过宏验证 (skip-macro-validation) 设置，以防止构建时出现错误。

• 该工具作为有状态的代理助手运行，利用每个工作区的守护进程 (daemon) 来无缝处理诸如日志流与调试会话等持久性任务。