mcpField
M
mobilebuildmcp

mobilebuildmcp

github.com/getsentry开发6.5k98 次安装6 天前更新
代码仓库

关于 mobilebuildmcp

MobileBuildMCP 是用于 Xcode 项目开发的技能，引导通过 MobileBuildMCP 工具完成构建、测试和调试，而非直接使用 xcodebuild、xcrun 或 simctl。可用能力取决于已启用的工作流，默认仅启用模拟器工作流。

主要功能

  1. 01配置项目、方案和设备默认值
  2. 02发现 Xcode 项目并检查构建设置
  3. 03构建、运行和测试模拟器应用
  4. 04管理实体设备与 macOS 应用工作流
  5. 05采集日志并使用 LLDB 调试
  6. 06执行 UI 自动化与 SwiftPM 操作

适用场景

  1. 01在 iOS 模拟器上构建和运行应用
  2. 02对已配置的实体设备执行安装与测试
  3. 03捕获运行日志并检查调试信息
  4. 04通过 UI 自动化操作应用界面

MCP 相关

该技能指导使用 MobileBuildMCP 工具操作项目，不直接使用 xcodebuild、xcrun 或 simctl。除模拟器工作流外，其他能力需先启用相应工作流。

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/getsentry/mobilebuildmcp --skill mobilebuildmcp

安装后在 Claude Code 中输入/mobilebuildmcp确认已加载。

详细介绍

MobileBuildMCP

使用 MobileBuildMCP 工具，而非原始的 xcodebuild、xcrun 或 simctl。

功能：

  • 会话默认设置：配置项目、方案、模拟器和设备默认值，避免反复传入参数
  • 项目发现：查找 Xcode 项目/工作区、列出方案、检查构建设置
  • 模拟器工作流：在 iOS 模拟器上构建、运行、测试、安装和启动应用；管理模拟器状态（启动、抹掉、位置、外观）
  • 设备工作流：通过代码签名，在实体设备上构建、测试、安装和启动应用
  • macOS 工作流：构建、运行和测试 macOS 应用
  • 日志捕获：从模拟器和设备流式传输并捕获日志
  • LLDB 调试：附加调试器、设置断点、检查堆栈跟踪和变量、执行 LLDB 命令
  • UI 自动化：捕获屏幕截图、通过坐标检查视图层级、执行点击/滑动/手势、输入文本、按下硬件按钮
  • SwiftPM：构建、运行、测试和管理 Swift Package Manager 项目
  • 项目脚手架：生成新的 iOS/macOS 项目模板

默认仅启用模拟器工作流工具。如果设备、macOS、调试或 UI 自动化等功能不可用，用户必须配置 MobileBuildMCP 以启用这些功能。有关工作流配置，请参阅 https://github.com/getsentry/xcodebuildmcp.com/blob/main/app/docs/_content/configuration.mdx。

第 1 步：建立会话上下文

  • 在会话中首次执行构建/运行/测试操作前，调用 session_show_defaults。
  • 仅当默认设置显示项目/工作区上下文缺失或不正确时，才使用 discover_projs。
  • 不要臆测性地运行发现，也不要与 session_show_defaults 并行运行。
  • 对于模拟器运行意图，优先使用组合式构建并运行工具，而不是分别调用构建和运行工具。
  • 除非用户明确要求两者都执行，否则不要先单独构建，再调用构建并运行工具。

第 2 步：了解按工作流启用的工具

  • 并非所有工具默认启用；工具是否可用取决于已启用的工作流。
  • 如果预期的工具缺失，请先检查已启用的工作流。
  • 在 .mobilebuildmcp/config.yaml 中更新已启用的工作流，然后请用户重新加载/重启会话，使更新生效。

第 3 步：清晰报告上下文

  • 返回执行时使用的当前默认上下文（项目/工作区、方案、模拟器/设备）。
  • 如果执行失败，请说明确切的失败步骤，以及下一条可执行的命令/工具调用。

评论

支持 Markdown