SuperAPI AI 工具集

xcodebuildmcp

编程与开发

查看项目

更新于 10-16 08:16

技能介绍

XcodeBuildMCP 是一个面向 Apple 平台(iOS/macOS/watchOS/tvOS/visionOS)开发工作的 MCP 技能集合。该技能建议在相关开发工作中优先使用 XcodeBuildMCP,而不是直接使用 raw xcodebuild、xcrun 或 simctl。如果发现缺少所需能力,应假定工具列表可能被隐藏(搜索/渐进式披露)或工具 schema 尚未加载,可使用工具搜索或“加载工具”机制;若仍找不到,请让用户在 MCP 客户端配置中启用。

使用方式:在调用其他工具前,必须先调用 session_show_defaults 显示当前默认值,随后填充缺失的默认值;可能需要调用一个或多个发现/列表工具来获取所需的值。应至少调用一次 session_set_defaults 来设置工具默认值。

会话默认值工具:session_set_defaults(设置会话默认值)、session_show_defaults(显示会话默认值)、session_clear_defaults(清除会话默认值)。

项目发现工具:discover_projs 扫描目录(默认为工作区根目录)以查找 Xcode 项目(.xcodeproj)与工作区(.xcworkspace)文件;list_schemes 列出 Xcode scheme;show_build_settings 显示构建设置;get_app_bundle_id 从 .app 提取 bundle id;get_mac_bundle_id 从 macOS .app 提取 bundle id。

模拟器工具:boot_sim 启动 iOS 模拟器;list_sims 列出 iOS 模拟器;open_sim 打开 Simulator 应用;build_sim 为 iOS 模拟器构建;build_run_sim 构建并在 iOS 模拟器运行;test_sim 在 iOS 模拟器测试;get_sim_app_path 获取模拟器构建的 app 路径;install_app_sim 在模拟器安装 app;launch_app_sim 在模拟器启动 app;launch_app_logs_sim 启动模拟器 app 并带日志;stop_app_sim 停止模拟器 app;record_sim_video 录制模拟器视频。

模拟器管理工具:erase_sims 抹除模拟器;set_sim_location 设置模拟器位置;reset_sim_location 重置模拟器位置;set_sim_appearance 设置模拟器外观;sim_statusbar 设置模拟器状态栏网络。

真机工具:list_devices 列出已连接设备;build_device 为真机构建;test_device 在真机测试;get_device_app_path 获取真机构建的 app 路径;install_app_device 在真机安装 app;launch_app_device 在真机启动 app;stop_app_device 停止真机 app。

macOS 工具:build_macos 构建 macOS app;build_run_macos 构建并运行 macOS app;test_macos 测试 macOS 目标;get_mac_app_path 获取 macOS 构建的 app 路径;launch_mac_app 启动 macOS app;stop_mac_app 停止 macOS app。

日志工具:start_device_log_cap 开始设备日志捕获;start_sim_log_cap 开始模拟器日志捕获;stop_device_log_cap 停止设备日志捕获;stop_sim_log_cap 停止模拟器日志捕获。

调试工具:debug_attach_sim 将 LLDB 附加到模拟器 app;debug_breakpoint_add 添加断点;debug_breakpoint_remove 移除断点;debug_continue 继续调试会话;debug_detach 分离调试器;debug_lldb_command 运行 LLDB 命令;debug_stack 获取回溯;debug_variables 获取帧变量。

UI 自动化工具:button 按下模拟器硬件按钮;gesture 模拟器手势预设;key_press 按 keycode 按键;key_sequence 按 keycode 序列按键;long_press 在坐标处长按;screenshot 截图;snapshot_ui 打印视图层级并给出可见元素的精确坐标(x、y、width、height);swipe 在点之间滑动;tap 点击坐标或元素;touch 在坐标处 touch down/up;type_text 输入文本。

SwiftPM 工具:swift_package_build 构建 swift package 目标;swift_package_clean 清理 swift package;swift_package_list 列出 SwiftPM 进程;swift_package_run 运行 swift package 目标;swift_package_stop 停止 SwiftPM 运行;swift_package_test 运行 swift package 目标测试。

脚手架/实用工具:scaffold_ios_project 搭建 iOS 项目;scaffold_macos_project 搭建 macOS 项目;clean 清理构建产物。

诊断工具:doctor 显示 MCP 环境信息;manage_workflows 管理工作流,工作流是 XcodeBuildMCP 暴露的工具组,默认并非启用所有工作流(因此也并非启用所有工具),默认仅启用模拟器工具,部分工作流为强制启用且不可禁用。

适用场景:Apple 平台应用的构建、测试、运行、调试、日志采集与 UI 自动化,以及 SwiftPM 与项目脚手架等开发流程。

限制:未提供收费、价格、平台支持范围之外的具体约束等信息;部分工作流默认未启用,需要按需启用;缺失能力需要借助工具搜索或 MCP 客户端配置解决。