“Xcode” MCP 服务器能做什么?
Xcode MCP(模型上下文协议)服务器是一款专为将 AI 助手与 Xcode 开发环境无缝连接而设计的工具。它通过标准协议开放丰富的 Xcode 相关操作,使 AI 智能体能够管理 Xcode 项目、自动处理文件、控制 iOS 模拟器,并与各种项目依赖和构建工具交互。这种深入集成极大地简化了开发流程,使诸如构建、测试、代码分析、依赖管理(CocoaPods 和 Swift 包管理器)及模拟器控制等任务,可以通过程序或智能助手自动完成。对于自动化重复性任务、提升代码质量、加速 iOS/macOS 项目开发而言,该服务器价值极高,让强大的 Xcode 功能通过自然语言或 AI 驱动界面变得易于访问。
提示模板列表
在可用仓库文件或文档中未提及任何提示模板。
资源列表
在可用仓库文件或文档中未列出任何明确的 MCP 资源。
工具列表
项目管理工具
- 设置活动项目并获取项目信息。
- 基于模版(如 iOS、macOS)新建 Xcode 项目。
- 向项目添加文件并指定目标或分组。
- 解析工作区文档并列出 scheme。
文件操作
- 读取和写入文件(支持编码)。
- 通过 base64 处理二进制文件。
- 使用模式/正则查找文本。
- 检查文件存在性及元数据。
- 自动创建目录。
构建与测试
- 自定义参数构建项目。
- 运行测试并报告失败。
- 代码分析。
- 清理构建目录。
- 项目归档用于分发。
CocoaPods 集成
- 初始化、安装、更新和管理 pods。
- 添加/移除 pod 依赖。
- 执行任意 pod 命令。
Swift 包管理器
- 管理 Swift 包及依赖。
- 更新/解析包。
- 生成文档。
- 构建与测试包。
iOS 模拟器工具
- 列出、启动、关闭模拟器。
- 安装和启动应用。
- 截图/录制视频。
- 管理模拟器设置。
Xcode 实用工具
- 通过
xcrun执行 Xcode 命令。 - 编译资源目录。
- 生成 App 图标集。
- 跟踪应用性能。
- 导出/验证归档以提交 App Store。
- 切换 Xcode 版本。
- 通过
典型应用场景
自动化项目搭建
AI 智能体可快速创建并配置新 Xcode 项目,设置 CocoaPods 或 Swift 包管理器等依赖管理工具,准备目录结构,大幅减少项目初始化的人力投入。持续集成与测试
自动化 iOS/macOS 项目的构建、测试和分析流程。AI 驱动例程可触发构建、执行测试并报告失败或代码问题,通过聊天或脚本接口支撑强大的 CI/CD 流水线。模拟器管理与测试
通过编程方式控制 iOS 模拟器,实现自动化 UI 测试、应用安装、截图/录屏等,提升移动端测试的覆盖面与可靠性。依赖管理
通过 CocoaPods 或 Swift 包管理器自动化三方库的添加、移除和更新,保证项目始终保持最新和兼容,减少人工干预。资源与构建工具
自动化资源编译、图标生成及构建产物管理(包括归档和 App Store 导出),提升效率并降低人为失误风险。
如何设置
Windsurf
- 确保已安装 macOS、Xcode(14.0+)、Node.js(16+)和 npm。
- 下载或克隆
xcode-mcp-server仓库。 - 运行安装脚本:
chmod +x setup.sh ./setup.sh - 编辑 Windsurf 配置文件以添加 MCP 服务器:
{ "mcpServers": { "xcode-mcp": { "command": "npx", "args": ["@xcode/mcp-server@latest"] } } } - 保存配置并重启 Windsurf,通过检查 Xcode MCP 工具可用性进行验证。
Claude
- 安装前置环境(macOS、Xcode、Node.js、npm)。
- 克隆仓库并按上述方式运行安装脚本。
- 找到 Claude 的 MCP 配置文件。
- 添加 Xcode MCP 服务器:
{ "mcpServers": { "xcode-mcp": { "command": "npx", "args": ["@xcode/mcp-server@latest"] } } } - 保存并重启 Claude。通过工具列表确认配置无误。
Cursor
- 确保所有依赖已安装。
- 克隆仓库并执行安装脚本。
- 打开 Cursor 的 MCP 配置文件。
- 在
mcpServers下添加以下内容:{ "mcpServers": { "xcode-mcp": { "command": "npx", "args": ["@xcode/mcp-server@latest"] } } } - 保存并重启 Cursor,验证服务器已成功激活。
Cline
- 配置前置环境并运行安装脚本。
- 编辑 Cline 的 MCP 服务器配置文件。
- 插入 Xcode MCP 服务器条目:
{ "mcpServers": { "xcode-mcp": { "command": "npx", "args": ["@xcode/mcp-server@latest"] } } } - 保存更改并重启 Cline。
- 确认 Xcode MCP 服务器在 Cline 内部已正常运行。
使用环境变量保护 API 密钥
- 将敏感数据(API 密钥、令牌等)放入
.env文件。 .env用法示例:XCODE_MCP_API_KEY=your_api_key_here- 在你的配置中引用环境变量:
{ "mcpServers": { "xcode-mcp": { "command": "npx", "args": ["@xcode/mcp-server@latest"], "env": { "XCODE_MCP_API_KEY": "${XCODE_MCP_API_KEY}" }, "inputs": { "projectBaseDir": "/Users/yourname/Projects" } } } }
如何在 FlowHunt 流程中使用 MCP
在 FlowHunt 中集成 MCP
要将 MCP 服务器集成到你的 FlowHunt 工作流,首先将 MCP 组件添加到流程,并与 AI 智能体连接:

点击 MCP 组件以打开配置面板。在系统 MCP 配置部分,使用如下 JSON 格式填写你的 MCP 服务器信息:
{
"xcode-mcp": {
"transport": "streamable_http",
"url": "https://yourmcpserver.example/pathtothemcp/url"
}
}
配置完成后,AI 智能体即可作为工具使用 MCP 并访问其所有功能。请记得将 “MCP-name” 替换为你实际的 MCP 服务器名称(如 “xcode-mcp”),并将 URL 换成你的 MCP 服务器地址。
概览
| 部分 | 可用性 | 说明/备注 |
|---|---|---|
| 概览 | ✅ | 涵盖项目、构建、依赖和模拟器控制 |
| 提示模板列表 | ⛔ | 未提及提示模板 |
| 资源列表 | ⛔ | 未列出明确的 MCP 资源 |
| 工具列表 | ✅ | 项目、构建、文件、依赖、模拟器、实用工具 |
| API 密钥安全配置 | ✅ | 提供 .env 用法和 JSON env 示例 |
| 采样支持(评测时次要) | ⛔ | 未提及 |
结合上述信息,Xcode MCP 服务器在 Xcode 自动化方面功能完备,但缺乏关于提示模板、明确 MCP 资源和采样/根功能的文档。其项目/构建工具能力强,且有清晰的搭建说明。
MCP 评分
| 是否有 LICENSE | ✅ (MIT) |
|---|---|
| 至少包含一个工具 | ✅ |
| Fork 数量 | 16 |
| Star 数量 | 262 |
总体上,我给这个 MCP 服务器的评分是 7/10。
它在 Xcode 集成和自动化工具方面非常全面,搭建文档清晰,且有明确的开源协议。但缺乏提示模板、明确 MCP 资源、根和采样支持,这些对于完整 MCP 兼容和高级工作流来说同样重要。
