SuperAPI AI 工具集

axiom-xcode-mcp-tools

编程与开发

查看项目

更新于 10-15 20:11

技能介绍

用途:本技能提供通过 Xcode MCP 以编程方式访问 IDE 的工作流模式,核心原则是使用循环式工作流而非孤立工具调用。

主要能力与工作流:

  1. 窗口定位:多数工具需要 tabIdentifier,须先调用 XcodeListWindows 获取 (tabIdentifier, workspacePath) 列表,匹配项目路径后缓存映射;若返回空说明 Xcode 未打开项目。
  2. BuildFix 循环:BuildProject → 检查 buildResult → GetBuildLog 解析错误 → XcodeListNavigatorIssues 获取规范诊断 → XcodeUpdate 修复 → 重复,最多 5 次;同一错误 3 次未解决则回退到 axiom-xcode-debugging。
  3. TestFix 循环:GetTestList → RunSomeTests 快速迭代 → 解析失败 → XcodeUpdate → 重复,最后 RunAllTests 验证。
  4. PreviewVerify:RenderPreview 渲染 SwiftUI 预览并检查图像,用于布局、深色模式、Liquid Glass 效果验证。
  5. IssueTriage:以 Issue Navigator 为规范诊断源,按错误>警告>提示优先级处理。
  6. DocumentationSearch:查询 Apple 在线文档与 WWDC 文字稿;Xcode 内置的 20 份 for-LLM 指南应改用 axiom-apple-docs。

文件操作:XcodeRead、XcodeWrite(新建)、XcodeUpdate(str_replace 式补丁)、XcodeGlob、XcodeGrep、XcodeLS、XcodeMakeDir;XcodeRM 与 XcodeMV 为破坏性操作,需用户确认。ExecuteSnippet 可在指定 Swift 文件上下文中执行代码,仅支持 Swift。

限制与注意事项:tabIdentifier 在窗口或项目重开、Xcode 重启后失效,需重新获取;XcodeWrite 会覆盖已有文件,编辑应使用 XcodeUpdate;Xcode 的 mcpbridge 存在 MCP 规范违规(声明 outputSchema 时省略 structuredContent),严格客户端可用 XcodeMCPWrapper 代理;文件修改后需重新构建以暴露新诊断。相关技能:axiom-xcode-mcp-setup、axiom-xcode-mcp-ref、axiom-xcode-debugging。