用途:XcodeBuildMCP 是面向 Apple 平台(iOS、macOS、watchOS、tvOS、visionOS)开发的官方技能,主张使用其工具而非直接调用 xcodebuild、xcrun 或 simctl,覆盖构建、测试、运行、调试、日志与 UI 自动化等环节。
主要能力:会话默认值(配置项目、scheme、模拟器与设备默认参数,减少重复传参);项目发现(查找 Xcode 项目/工作区、列出 scheme、查看构建设置);模拟器工作流(构建、运行、测试、安装、启动应用,管理启动、抹除、位置、外观等状态);真机工作流(带代码签名的构建、测试、安装与启动);macOS 工作流(构建、运行、测试 macOS 应用);日志捕获(从模拟器与设备流式获取日志);LLDB 调试(附加调试器、设置断点、查看堆栈与变量、执行 LLDB 命令);UI 自动化(截图、带坐标检查视图层级、点击/滑动/手势、输入文本、按硬件按钮);SwiftPM(构建、运行、测试与管理 Swift Package Manager 项目);项目脚手架(生成新的 iOS/macOS 项目模板)。
使用方式:默认仅启用模拟器工作流工具;若设备、macOS、调试或 UI 自动化等能力不可用,需自行配置启用,参见 https://xcodebuildmcp.com/docs/configuration。会话中首次构建/运行/测试前先调用 session_show_defaults;仅当默认值缺少或项目/工作区上下文不正确时才用 discover_projs,不要臆测式发现或与 session_show_defaults 并行执行。模拟器运行意图优先使用合并的构建并运行工具,不要串联仅构建再构建并运行,除非用户明确要求两者。工具可用性取决于已启用的工作流,若预期工具缺失先检查工作流,在 .xcodebuildmcp/config.yaml 中更新后请用户重载或重启会话。执行后应返回所用默认上下文(项目/工作区、scheme、模拟器/设备),失败时给出确切失败步骤与下一步可执行的命令或工具调用。
适用场景:Apple 平台应用的日常构建、测试、运行、调试、日志排查与 UI 自动化。
限制:默认只启用模拟器工作流;其他能力需配置开启;具体配置项与完整工具清单以官方文档为准,资料未提供更多细节。