xcode

XcodeBuildMCP

通过 mcporter 使用 XcodeBuildMCP 进行 Xcode 和 Swift 工作：

bunx mcporter call --stdio "xcodebuildmcp" <tool_name> [args...]

假设 mcporter 和 xcodebuildmcp 已全局安装。此处 bunx 用于运行已安装的二进制文件；不得获取不可信的替代版本。

探查环境

在构建前确定目标：

bunx mcporter call --stdio "xcodebuildmcp" doctor
bunx mcporter call --stdio "xcodebuildmcp" discover_projs workspaceRoot="$(pwd)"
bunx mcporter call --stdio "xcodebuildmcp" list_schemes
bunx mcporter call --stdio "xcodebuildmcp" list_sims

进行实体设备相关工作时，应探查已连接的设备，而不是猜测标识符。区分 Xcode 项目、工作区、Swift 包、模拟器目标、实体设备和 macOS 应用；针对对应的目标类别选择工具。

设置会话默认值

在大多数构建和测试调用前，设置项目／工作区、方案和目标设备默认值：

bunx mcporter call --stdio "xcodebuildmcp" session-set-defaults \
  projectPath="/path/to/App.xcodeproj" \
  scheme="App" \
  simulatorName="<discovered simulator>"

对于工作区，使用 workspacePath；对于特定模拟器或设备，使用探查到的标识符。如果行为异常，请检查默认值：

bunx mcporter call --stdio "xcodebuildmcp" session-show-defaults

不要在互不相关的代码库或目标之间沿用过期的默认值。

执行请求的工作流

设置目标后：

1. 选择对应的模拟器、设备、macOS 或 Swift 包工具。
2. 除非适用组合式构建并运行工具，否则先构建，再尝试安装或启动。
3. 先运行针对性测试，再视情况运行更全面的测试。
4. 保留构建输出，并指出可采取行动的编译器／测试失败信息。
5. 需要运行时证据时，在复现问题前后使用日志捕获工具，并在之后停止捕获。

创建脚手架时，确认目标位置、项目名称、平台和 bundle 标识符。不要在未明确确认的情况下覆盖现有项目。

模拟器 UI 交互

构建并启动应用，然后在每次交互序列之前检查当前的无障碍层级：

bunx mcporter call --stdio "xcodebuildmcp" describe_ui

优先使用无障碍标识符或标签。仅使用最新层级中的坐标；不得根据截图猜测坐标，也不得在 UI 变化后重复使用坐标。如果视觉证据很重要，请截屏。导航、对话框、旋转或其他布局变化后，重新运行 describe_ui。

使用实时工具架构

工具名称和参数可能随 XcodeBuildMCP 版本变化。不要依赖复制的工具目录。使用不熟悉的操作前，检查已安装的 mcporter 帮助信息和 XcodeBuildMCP 架构：

bunx mcporter --help
bunx mcporter list --stdio "xcodebuildmcp" --schema

对手势、模拟器设置、录制、日志、设备操作、Swift 包、脚手架和实用工具，均应使用实时架构。

诊断故障

• 缺少项目／工作区：检查并设置会话默认值。
• 模拟器／设备未知：重新探查可用目标设备。
• 环境或集成故障：运行 doctor 并检查确切的错误。
• 增量构建问题：仅在实时架构支持时，尝试使用服务端的标准 xcodebuild 首选项。
• 构建或测试失败：根据输出的编译器／测试证据进行诊断，不要将其视为 MCP 故障。