Xcode MCP 集成

连接 Xcode 的 mcpbridge，在 Cursor 中构建、测试和检查 SwiftUI 预览。

This page has not been translated into English yet. The original Chinese version is shown below.

Xcode 26.3 或以上提供内建 MCP server，通过 Apple 的 xcrun mcpbridge 将 MCP 请求转到 Xcode 内部服务。需要 macOS、付费 Cursor 套餐，以及正在运行并已打开项目的 Xcode。

打开与连接

在 Xcode > Settings > Intelligence 的 Model Context Protocol 区域启用 Xcode Tools。官方排障部分也将允许连接的开关称为 Allow external agents，按所用版本实际界面确认。

在 Cursor Customize > MCPs 添加名为 xcode-tools 的 stdio server，命令为 xcrun mcpbridge，或写入 MCP 配置：

{
  "mcpServers": {
    "xcode-tools": {
      "type": "stdio",
      "command": "xcrun",
      "args": ["mcpbridge"]
    }
  }
}

也可用 CLI 注册，编辑器与 CLI 共用该 MCP 配置：

agent mcp add xcode-tools -- xcrun mcpbridge

工具能力

官方当前列出 20 个工具。文件类含 XcodeRead、XcodeWrite、XcodeUpdate、XcodeGrep、XcodeGlob、XcodeLS、XcodeMakeDir、XcodeRM、XcodeMV；XcodeRead 每次最多 600 行，可通过 offset/limit 分页。

BuildProject 构建 active scheme，GetBuildLog 查询日志；RunAllTests、RunSomeTests 与 GetTestList 管理测试。XcodeListNavigatorIssues 与 XcodeRefreshCodeIssuesInFile 检查诊断，RenderPreview 截取 SwiftUI preview，DocumentationSearch 搜索 Apple 文档和 WWDC，ExecuteSnippet 运行 Swift 片段，XcodeListWindows 列出窗口与 tabs。

先让 Agent 读项目，再改动、构建、运行相关测试，最后用预览检查界面；Xcode 保持打开并负责后台编译。

排障

找不到 server 时确认 Xcode 已打开项目。缺 tabIdentifier 表示工具需要 workspace 上下文，空窗口不足。构建或测试超时时先查看 Xcode 是否仍在执行，避免直接重复长任务。

若 xcrun 找不到 mcpbridge，系统可能选择了 Command Line Tools。官方提供以下切换完整 Xcode 的命令，路径按实际安装位置核实：

sudo xcode-select -s /Applications/Xcode.app/Contents/Developer
sudo xcodebuild -runFirstLaunch
xcrun --find mcpbridge

最后一条应返回文件路径。重新打开项目、允许外部 Agent，再在 Cursor 启用 server，并确认 Xcode 的连接权限弹窗。