SuperAPI AI 工具集

xcode-tools

编程与开发

查看项目

更新于 10-15 23:33

技能介绍

用途:本技能是 Xcode 27 内置 MCP 服务器(mcpbridge)的操作指南,用于从 Claude Code 驱动 Xcode。工作模型是:Claude Code 作为编辑器,Xcode 作为附加的构建/运行/调试/文档服务;Xcode 需保持打开以便其服务可达,不要假设 Xcode UI 状态(当前文件、选中项)有意义,且部分调用会改变人类可见的状态(运行目标、调试器、模拟器)。

主要能力与用法:会话引导(每会话一次)先调用 XcodeListWindows,从消息文本解析 tabIdentifier,多窗口时按 workspacePath 匹配;无工作区则其余工具不可用。tabIdentifier 是 Xcode 侧状态,随 Xcode 存亡;工具在智能体会话启动时枚举,若当时 Xcode 未运行则工具缺失,需重连或重启。

分工原则:SwiftPM 包(Package.swift)中成员关系即文件夹布局,用原生文件工具即可;.xcodeproj 项目中成员关系存于 pbxproj,文件生命周期须走 Xcode 工具。读文件用原生 Read,搜索用原生 Grep/Glob,编辑已有文件用原生 Edit(XcodeUpdate 会静默改第一处匹配),创建/删除/重命名/移动文件用 XcodeWrite/XcodeRM/XcodeMV。单文件编译检查用 XcodeRefreshCodeIssuesInFile,完整构建用 BuildProject,测试用 RunSomeTests/RunAllTests(SwiftPM 用 swift test),启动调试用 RunProject(attachDebugger:true) 加 InvokeDebuggerCommand,控制台输出用 GetConsoleOutput,SwiftUI 预览用 RenderPreview,代码片段用 RunCodeSnippet,构建设置/Info.plist/entitlements 用 MCP 设置工具,字符串目录用 StringCatalog* 工具,iOS UI 操作用 DeviceInteraction* 套件(需 iOS 模拟器 27.0+,仅 iOS)。

限制:部分响应体积大(如 GetTargetBuildSettings 约 26KB、DocumentationSearch 约 30KB/次、XcodeListRunDestinations 约 15KB),需过滤或避免;GetBuildLog 与 XcodeListNavigatorIssues 默认 severity 为 error,仅警告的构建会显示为空。安装命令:claude mcp add --scope user xcode-tools --env DEVELOPER_DIR=/Applications/Xcode-beta.app/Contents/Developer -- /Applications/Xcode-beta.app/Contents/Developer/usr/bin/mcpbridge。故障时检查 Xcode 是否运行、是否打开项目、可用 MCP_XCODE_PID 指定 Xcode。