Xcode 26.3+ 內置 MCP 服務器，讓 Cursor 可直接訪問您的 Xcode 項目。Cursor 的智能體可以讀取和編輯文件、觸發構建、運行測試、捕獲 SwiftUI 預覽，以及搜索 Apple 文檔，全程無需離開編輯器。
該功能通過 xcrun mcpbridge 實現。這是 Apple 隨 Xcode 提供的二進制文件，可將 MCP 協議消息轉換爲 Xcode 內部的 XPC 層。只需配置一次，Cursor 就會將 Xcode 的 20 個內置工具當作其他 MCP 服務器的工具一樣使用。
前提條件¶
- 已安裝 Xcode 26.3 或更高版本的 macOS
- 已訂閱付費 Cursor 方案
- 已在 Xcode 中打開的 Xcode 項目 (Xcode 必須正在運行)
在 Xcode 中啓用 MCP¶
要讓 Cursor 連接，請先啓用 Xcode 的 MCP 橋接：
打開 Xcode 設置¶
前往 Xcode > 設置 > Intelligence。
啓用 MCP¶
在 模型上下文協議 下，開啓 Xcode Tools。
設置 Cursor¶
選擇適合您工作流的方式。
選項 1：MCP 設置界面¶
打開 MCP 設置¶
前往 自定義 > MCP。
添加服務器¶
點擊 添加新 MCP 服務器。將傳輸方式設置爲 stdio，名稱設爲 xcode-tools，並在命令欄中輸入 xcrun mcpbridge。
選項 2：mcp.json¶
在 MCP 配置文件中添加以下條目：
```json title=”~/.cursor/mcp.json”
{
“mcpServers”: {
“xcode-tools”: {
“command”: “xcrun”,
“args”: [“mcpbridge”]
}
}
}
### 選項 3：Cursor 命令行界面
如果您使用 [Cursor 命令行界面](https://cursor.com/docs/cli/overview)，請在終端中註冊服務器：
```bash
agent mcp add xcode-tools -- xcrun mcpbridge
命令行界面與編輯器共用同一份 MCP 配置，因此該服務器會同時顯示在兩處。
可用工具¶
Xcode 提供 20 個 MCP 工具，分爲五大類：
文件操作¶
- XcodeRead - 讀取文件內容 (每次調用最多 600 行；較大文件可通過 offset/limit 指定偏移量和行數)
- XcodeWrite - 創建或覆蓋文件
- XcodeUpdate - 對現有文件進行定向編輯
- XcodeGrep - 使用正則表達式搜索文件內容
- XcodeGlob - 按模式查找文件
- XcodeLS - 列出目錄內容
- XcodeMakeDir - 創建目錄
- XcodeRM - 刪除文件或目錄
- XcodeMV - 移動或重命名文件
構建與測試¶
- BuildProject - 構建當前方案
- GetBuildLog - 獲取構建日誌，可按嚴重程度、正則表達式或文件 glob 篩選
- RunAllTests - 運行完整測試套件
- RunSomeTests - 運行指定測試類或方法
- GetTestList - 列出可用測試
診斷¶
- XcodeListNavigatorIssues - 顯示問題導航器中的警告和錯誤
- XcodeRefreshCodeIssuesInFile - 重新檢查文件中的代碼問題
智能¶
- RenderPreview - 截取 SwiftUI 預覽的截圖
- DocumentationSearch - 在 Apple 文檔和 WWDC 會話記錄中進行語義搜索
- ExecuteSnippet - 運行 Swift 代碼片段
工作區¶
- XcodeListWindows - 列出打開的 Xcode 窗口和標籤頁
示例工作流¶
典型的 Cursor + Xcode 工作流如下：
- 在 Cursor 和 Xcode 中打開您的項目
- 請 Cursor 的智能體添加功能或修復缺陷
- 智能體使用 XcodeRead 和 XcodeGrep 瞭解您的代碼
- 它使用 XcodeWrite 或 XcodeUpdate 編輯文件
- 它運行 BuildProject 檢查錯誤，並通過 GetBuildLog 查看結果
- 它使用 RunSomeTests 運行測試以驗證更改
- 它使用 RenderPreview 渲染 SwiftUI 預覽以確認 UI
全程都在 Cursor 中操作。Xcode 會在後臺處理編譯、測試和預覽。
在 Xcode 中使用 Cursor 命令行界面¶
Cursor 命令行界面 也支持 Xcode 的 MCP 工具，適用於無圖形界面的工作流、CI 流水線或偏好終端的開發者。
# 使用可用的 Xcode 工具運行智能體
agent "Add unit tests for the NetworkManager class"
智能體會從你的配置中讀取 xcode-tools MCP 服務器，並使用編輯器中可用的同一套工具。
疑難排查¶
Cursor 找不到 xcode-tools 服務器¶
請確保 Xcode 正在運行且已打開項目。xcrun mcpbridge 進程需要連接到活躍的 Xcode 會話。
工具提示缺少 tabIdentifier¶
部分 Xcode MCP 工具需要工作區上下文。請確認你在 Xcode 中打開了項目或工作區，而不是空白窗口。
構建或測試工具超時¶
大型項目的構建時間更長。請直接查看 Xcode 的構建進度。MCP 橋接會等待 Xcode 的響應，因此超時通常意味着底層操作仍在運行。
Xcode 設置中沒有 MCP 開關¶
你需要 Xcode 26.3 或更高版本。請在 Xcode > About Xcode 中查看版本，並通過 Mac App Store 或 Apple Developer 下載更新。
xcrun: error: unable to find utility “mcpbridge”¶
你的系統當前指向 Command Line Tools，而非完整的 Xcode 安裝。請運行以下命令修復：
sudo xcode-select -s /Applications/Xcode.app/Contents/Developer
sudo xcodebuild -runFirstLaunch
然後確認橋接可用：
xcrun --find mcpbridge
該命令應返回文件路徑，而不是報錯。成功後，打開包含項目的 Xcode，前往 設置 > Intelligence > Model Context Protocol，並啓用 Allow external agents。然後在 Cursor 設置中重新啓用 Xcode MCP 服務器。你應該會在 Xcode 中看到確認連接的權限對話框。
相關內容¶
MCP 概覽¶
MCP 完整指南，涵蓋設置、配置和身份驗證
iOS 和 macOS（Swift）¶
使用 Cursor、Sweetpad 和 Xcode Build Server 的 Swift 開發工作流
Cursor 命令行界面¶
在終端中使用 Cursor 的智能體
CLI MCP 命令¶
通過命令行管理 MCP 服務器
