Xcode构建MCP

概述

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

先决条件与MCP设置

此技能假设 XcodeBuildMCP 服务器已安装并暴露给你的 MCP 客户端，以便工具可见（例如，mcp__xcodebuildmcp__build_run_sim）。如果缺少工具，请按照以下步骤进行设置：

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

请求示例

• "在最新的模拟器上构建并运行iOS应用，并截图。"
• "在模拟器上运行单元测试并分享失败的测试日志。"
• "打开模拟器，导航到设置，并切换深色模式。"
• "在我的已连接iPhone上安装并启动应用。"

快速开始（常用流程）

1. 发现项目/工作区和方案：

   • 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以减少参数干扰。
• 如果用户没有指定目标设备/模拟器，请列出选项并询问（或选择一个合理的默认值，并使用最新的操作系统）。
• 避免执行破坏性操作（如清除模拟器、清理），除非用户明确要求。