xcode-mcp
2025.03.28
2
JavaScriptXcode 工具链iOS 开发自动化开发效率
xcode-mcp 是一个基于 MCP（Model Context Protocol）的服务器，专门为 Xcode 相关操作提供工具支持。它简化了从 MCP 客户端（如 Claude Desktop）与 Xcode 项目的交互，涵盖了项目信息检索、构建、测试、归档、代码签名以及 iOS 开发工具管理等全方位功能。
View on GitHub
Overview
产品定位
xcode-mcp 是一个专为 Xcode 项目管理和 iOS 开发流程优化的 MCP 服务器，旨在通过标准化协议提供高效的开发工具链集成。
核心功能
- Xcode 项目管理：检索项目信息、列出方案/目标/配置
- 构建系统：支持清洁构建、自定义输出目录和多种构建配置
- 测试框架：精细化测试控制（特定测试用例、测试计划管理）
- 分发支持：应用归档与 IPA 导出（支持 App Store/企业分发）
- 签名管理：代码签名身份与描述文件检查
- SPM 集成：完整的 Swift 包管理功能
- 设备支持：
- 模拟器全生命周期管理（创建/启动/安装）
- 真机部署与日志流式传输（支持韩语设备名）
- 智能优化：
- 安装失败自动重试机制
- 设备信息智能缓存
- 直接 BundleID 指定（无需项目文件）
适用场景
- 持续集成：自动化构建、测试、归档流程
- 团队协作：统一开发环境配置检查
- 快速调试：真机实时日志流式传输
- 多环境管理：不同 Xcode 版本间的平滑切换
- LLM 辅助开发：通过自然语言指令串联开发流程
工具列表
| 工具名称 | 能力描述 |
|---|---|
xcode-project-info |
获取项目结构详情（目标/配置/方案） |
xcode-list-schemes |
可视化展示所有可用方案 |
xcode-build |
支持清洁构建与自定义输出目录 |
xcode-test |
精细化测试控制（特定测试用例/计划） |
xcode-archive |
生成可分发的归档文件 |
xcode-codesign-info |
检查代码签名配置 |
swift-package-manager |
完整的 SPM 命令支持 |
simctl-manager |
模拟器全生命周期管理 |
run-on-device |
真机部署与调试（支持韩语设备名） |
常见问题
- Xcode 版本要求：
- 基础功能需 Xcode 14+
- 真机功能需 Xcode 16+
- 设备连接问题：
- 确保设备已信任开发电脑
- 使用
listDevices参数验证设备识别 - 签名错误处理：
- 通过
xcode-codesign-info检查签名配置 - 确认描述文件未过期
使用教程
前置依赖
# 确保 Node.js 环境
node --version # 需 ≥ v16
# 检查 Xcode 命令行工具
xcode-select -p # 应返回有效路径
安装步骤
# 通过 npm 安装
npm install @devyhan/xcode-mcp
# 验证安装
npx @devyhan/xcode-mcp --version
调试命令
# 获取设备列表（验证基础功能）
npx @devyhan/xcode-mcp simctl-manager --command list
# 测试项目结构解析
npx @devyhan/xcode-mcp xcode-project-info --projectPath /path/to/project
# 实时设备日志（需真机连接）
npx @devyhan/xcode-mcp run-on-device \
--projectPath /path/to/project \
--scheme YourScheme \
--device "你的iPhone" \
--streamLogs true