Xcode Tools Docs

Xcode工具文档

Xcode MCP服务器（又称Xcode工具）的全面参考。这些工具使AI助手能够与Xcode工作区进行交互——管理文件、构建项目、运行测试、渲染预览等。

苹果文档

• 设置编码智能
• 在Xcode中使用智能编写代码
• 让代理编码工具访问Xcode

先决条件

• Xcode 26.3+已安装并在开放式工作区中运行
• 配置了Xcode集成的MCP服务器

注： 大多数工具都需要 tabIdentifier 标识要在哪个Xcode工作区选项卡上操作的参数。

安装

通过以下方式将Xcode MCP服务器添加到您的编码工具中 xcrun mcpbridge:

克劳德代码：

claude mcp add --transport stdio xcode -- xcrun mcpbridge

食品法典：

codex mcp add xcode -- xcrun mcpbridge

证实 claude mcp list 或 codex mcp list.

模式

tools.json 包含直接从生成的完整MCP工具定义（名称、标题、描述、输入/输出模式） xcrun mcpbridge.

目录

• 工作区

- X代码列表窗口

• 文件操作

- Xcodels - Xcodeglow - Xcodegrep - XcodeRead - XcodeWrite - XcodeUpdate - Xcodemakedir - XcodeMV - XcodeRM

• 构建与运行

- 建筑项目 - GetBuildLog - 执行代码段

• 测试

- GetTestList - 运行所有测试 - RunSome测试

• 诊断

- XcodeRefreshCodeIssuesInFile - Xcodelistnavigator问题

• 预览

- 渲染审查

• 文档

- 文档搜索

______________________________________________________________________

工作区

X代码列表窗口

列出当前Xcode窗口及其工作区信息。使用此项获取 tabIdentifier 所有其他工具所需的值。

参数： 无

例子：

XcodeListWindows()

______________________________________________________________________

文件操作

Xcodels

列出给定路径下Xcode项目结构中的文件和目录。在项目导航器层次结构上操作，而不是在文件系统上操作。

例子：

XcodeLS(tabIdentifier: "...", path: "MyApp/Sources/")

Xcodeglow

在Xcode项目中查找与通配符模式匹配的文件。支持 *, **, ?, [abc]，以及 {swift,m} 语法。

例子：

XcodeGlob(tabIdentifier: "...", pattern: "**/*.swift")

Xcodegrep

在Xcode项目结构中使用正则表达式模式搜索文件内容。

例子：

XcodeGrep(
  tabIdentifier: "...",
  pattern: "func viewDidLoad",
  type: "swift",
  outputMode: "content",
  linesAfter: 5
)

XcodeRead

读取带有行号的文件内容(cat -n 格式）。支持大文件的偏移/限制。

例子：

XcodeRead(tabIdentifier: "...", filePath: "MyApp/Sources/ContentView.swift")

XcodeWrite

在Xcode项目中创建或覆盖文件。自动将新文件添加到项目结构中。

例子：

XcodeWrite(
  tabIdentifier: "...",
  filePath: "MyApp/Sources/NewFeature.swift",
  content: "import Foundation\n\nstruct NewFeature {\n}\n"
)

XcodeUpdate

通过查找和替换文本来编辑文件。在项目结构路径上运行。

例子：

XcodeUpdate(
  tabIdentifier: "...",
  filePath: "MyApp/Sources/ContentView.swift",
  oldString: "Hello, World!",
  newString: "Hello, SwiftUI!"
)

Xcodemakedir

在Xcode项目导航器中创建目录和组。

例子：

XcodeMakeDir(tabIdentifier: "...", directoryPath: "MyApp/Sources/ViewModels")

XcodeMV

在项目导航器中移动、复制或重命名文件和目录。

例子：

XcodeMV(
  tabIdentifier: "...",
  sourcePath: "MyApp/Sources/OldName.swift",
  destinationPath: "MyApp/Sources/NewName.swift"
)

XcodeRM

从Xcode项目中删除文件和目录。可选择删除底层文件系统文件。

例子：

XcodeRM(tabIdentifier: "...", path: "MyApp/Sources/Deprecated.swift")

______________________________________________________________________

构建与运行

建筑项目

使用活动方案构建Xcode项目并等待完成。

例子：

BuildProject(tabIdentifier: "...")

GetBuildLog

从当前或最近的生成中检索生成日志条目。按严重性、文件模式或消息正则表达式过滤。

例子：

GetBuildLog(tabIdentifier: "...", severity: "warning")

执行代码段

在特定源文件的上下文中构建并运行代码段。该代码段可以访问该文件中的所有声明，包括 fileprivate 一个。输出来自 print 声明。

注： 仅适用于构建应用程序、框架、库或CLI可执行文件的目标中的源文件。

例子：

ExecuteSnippet(
  tabIdentifier: "...",
  sourceFilePath: "MyApp/Sources/Models/User.swift",
  codeSnippet: "let user = User(name: \"Test\")\nprint(user)"
)

______________________________________________________________________

测试

GetTestList

从活动方案的活动测试计划中获取所有可用测试。结果仅限于100次测试。完整列表已写入 fullTestListPath 以grep友好的格式使用grep，键如下 TEST_TARGET, TEST_IDENTIFIER，或 TEST_FILE_PATH 找到具体的测试。

例子：

GetTestList(tabIdentifier: "...")

运行所有测试

运行活动方案的活动测试计划中的每个测试。

例子：

RunAllTests(tabIdentifier: "...")

RunSome测试

按目标和标识符运行特定测试。使用 GetTestList 首先发现可用的测试标识符。

每个测试说明符对象：

例子：

RunSomeTests(
  tabIdentifier: "...",
  tests: [
    { "targetName": "MyAppTests", "testIdentifier": "MyAppTests/LoginTests/testValidLogin" }
  ]
)

______________________________________________________________________

诊断

XcodeRefreshCodeIssuesInFile

检索特定文件的当前编译器诊断（错误、警告、注释）。

例子：

XcodeRefreshCodeIssuesInFile(
  tabIdentifier: "...",
  filePath: "MyApp/Sources/ContentView.swift"
)

Xcodelistnavigator问题

从Xcode的Issue Navigator中列出问题，包括构建错误、包解析问题和工作区配置问题。

例子：

XcodeListNavigatorIssues(tabIdentifier: "...", severity: "warning")

______________________________________________________________________

预览

渲染审查

构建并渲染SwiftUI预览，返回结果UI的快照。

例子：

RenderPreview(
  tabIdentifier: "...",
  sourceFilePath: "MyApp/Sources/Views/ProfileView.swift"
)

______________________________________________________________________

文档

文档搜索

使用语义匹配搜索Apple开发者文档。可用于查找API、框架和使用模式。

作者

阿特姆·诺维奇科夫，https://artemnovichkov.com