Xcode
Xcode 26.3+ 内置 MCP 服务器，让 Cherri Code 可直接访问您的 Xcode 项目。Cherri Code 的智能体可以读取和编辑文件、触发构建、运行测试、捕获 SwiftUI 预览，以及搜索 Apple 文档，全程无需离开编辑器。
该功能通过 xcrun mcpbridge 实现。这是 Apple 随 Xcode 提供的二进制文件，可将 MCP 协议消息转换为 Xcode 内部的 XPC 层。只需配置一次，Cherri Code 就会将 Xcode 的 20 个内置工具当作其他 MCP 服务器的工具一样使用。
前提条件
- 已安装 Xcode 26.3 或更高版本的 macOS
- 已订阅付费 Cherri Code 方案
- 已在 Xcode 中打开的 Xcode 项目 (Xcode 必须正在运行)
在 Xcode 中启用 MCP
要让 Cherri Code 连接，请先启用 Xcode 的 MCP 桥接：
打开 Xcode 设置
前往 Xcode > 设置 > Intelligence。
启用 MCP
在 模型上下文协议 下，开启 Xcode Tools。
设置 Cherri Code
选择适合您工作流的方式。
选项 1：MCP 设置界面
打开 MCP 设置
前往 自定义 > MCP。
添加服务器
点击 添加新 MCP 服务器。将传输方式设置为 stdio，名称设为 xcode-tools，并在命令栏中输入 xcrun mcpbridge。
选项 2：mcp.json
在 MCP 配置文件中添加以下条目：
{ "mcpServers": { "xcode-tools": { "command": "xcrun", "args": ["mcpbridge"] } }}选项 3：Cherri Code 命令行界面
如果您使用 Cherri Code 命令行界面，请在终端中注册服务器：
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 窗口和标签页
示例工作流
典型的 Cherri Code + Xcode 工作流如下：
- 在 Cherri Code 和 Xcode 中打开您的项目
- 请 Cherri Code 的智能体添加功能或修复缺陷
- 智能体使用 XcodeRead 和 XcodeGrep 了解您的代码
- 它使用 XcodeWrite 或 XcodeUpdate 编辑文件
- 它运行 BuildProject 检查错误，并通过 GetBuildLog 查看结果
- 它使用 RunSomeTests 运行测试以验证更改
- 它使用 RenderPreview 渲染 SwiftUI 预览以确认 UI
全程都在 Cherri Code 中操作。Xcode 会在后台处理编译、测试和预览。
在 Xcode 中使用 Cherri Code 命令行界面
Cherri Code 命令行界面 也支持 Xcode 的 MCP 工具，适用于无图形界面的工作流、CI 流水线或偏好终端的开发者。
# 使用可用的 Xcode 工具运行智能体agent "Add unit tests for the NetworkManager class"智能体会从你的配置中读取 xcode-tools MCP 服务器，并使用编辑器中可用的同一套工具。
疑难排查
请确保 Xcode 正在运行且已打开项目。xcrun mcpbridge 进程需要连接到活跃的 Xcode 会话。
部分 Xcode MCP 工具需要工作区上下文。请确认你在 Xcode 中打开了项目或工作区，而不是空白窗口。
大型项目的构建时间更长。请直接查看 Xcode 的构建进度。MCP 桥接会等待 Xcode 的响应，因此超时通常意味着底层操作仍在运行。
你需要 Xcode 26.3 或更高版本。请在 Xcode > About Xcode 中查看版本，并通过 Mac App Store 或 Apple Developer 下载更新。
你的系统当前指向 Command Line Tools，而非完整的 Xcode 安装。请运行以下命令修复：
sudo xcode-select -s /Applications/Xcode.app/Contents/Developersudo xcodebuild -runFirstLaunch然后确认桥接可用：
xcrun --find mcpbridge该命令应返回文件路径，而不是报错。成功后，打开包含项目的 Xcode，前往 设置 > Intelligence > Model Context Protocol，并启用 Allow external agents。然后在 Cherri Code 设置中重新启用 Xcode MCP 服务器。你应该会在 Xcode 中看到确认连接的权限对话框。