Xcodebuildmcp

概述

使用 xcodebuildmcp 工具集构建/运行/测试应用、管理模拟器/设备、自动化 UI 操作，以及捕获日志与屏幕媒体。默认采用安全、可重复的流程：发现 → 设置默认值 → 执行 → 验证。

前提条件与 MCP 配置

本能力假设 XcodeBuildMCP 服务已安装并暴露给您的 MCP 客户端，从而使相关工具可见（例如：mcp__xcodebuildmcp__build_run_sim）。若工具缺失，请参考以下文档完成配置：

• references/mcp-setup.md（包含依赖要求及 MCP 客户端配置示例）

示例请求

• “在最新版本的 iOS 模拟器上构建并运行该应用，并截取一张屏幕截图。”
• “在模拟器上运行单元测试，并分享失败测试的日志。”
• “启动模拟器，导航至‘设置’，然后切换深色模式。”
• “在我的已连接 iPhone 上安装并启动该应用。”

快速入门（常用流程）

1. 发现项目/工作区及可用 scheme：

   • mcp__xcodebuildmcp__discover_projs
   • mcp__xcodebuildmcp__list_schemes

2. 设置会话默认值（使后续工具无需重复传入参数）：

   • mcp__xcodebuildmcp__session-set-defaults（指定 workspacePath/projectPath、scheme、simulatorId 或 deviceId）

3. 执行任务：

   • 构建与运行：mcp__xcodebuildmcp__build_run_sim 或 mcp__xcodebuildmcp__build_run_macos
   • 测试：mcp__xcodebuildmcp__test_sim / mcp__xcodebuildmcp__test_macos / mcp__xcodebuildmcp__test_device

4. 验证结果并收集证据：

   • mcp__xcodebuildmcp__screenshot（仅限模拟器）
   • mcp__xcodebuildmcp__start_sim_log_cap → mcp__xcodebuildmcp__stop_sim_log_cap

任务索引

• 构建/运行：iOS 模拟器、macOS 应用、设备安装
• 测试：模拟器 / macOS / 设备
• 模拟器管理：列出 / 启动 / 清除 / 外观设置 / 位置模拟 / 手势模拟
• UI 自动化：描述 UI → 点击 / 输入 / 滑动 / 手势操作
• 日志与调试：模拟器日志、设备日志、LLDB 附加 / 断点
• 媒体：屏幕截图、屏幕录制

请加载 references/workflows.md 查看详细分步操作流程与命令模式。

运行规则

• 在执行基于坐标的点击、滑动或长按操作前，必须先调用 mcp__xcodebuildmcp__describe_ui。
• 建议尽早调用 mcp__xcodebuildmcp__session-set-defaults，以减少参数冗余。
• 若用户未明确指定目标设备或模拟器，应先列出可选项并询问用户，或使用 useLatestOS 选取合理默认值。
• 除非用户明确要求，否则避免执行破坏性操作（如清除模拟器、执行 clean）。