🚀 XcodeBuildMCP 项目文档

XcodeBuildMCP 是一款与 Xcode 交互的工具，借助模型上下文协议 (MCP) 提供增强功能，能助力开发者更高效地管理和自动化 Xcode 项目。

🚀 快速开始

XcodeBuildMCP 能为开发者带来诸多便利，下面为你介绍如何开启使用之旅。

📦 安装指南

1. 通过 npm 安装：

   npm install -g xcodebuildmcp@1.3.1
   

2. 全局配置： 配置 XcodeBuildMCP 的运行环境变量，确保其正常工作。

✨ 主要特性

1. Xcode 项目管理

• 构建功能：支持快速构建 Xcode 项目。
• 诊断工具：提供详细的环境检查和依赖项状态报告。

2. 模拟器管理

• 模拟器控制：支持启动、重启和停止模拟器。
• 屏幕截图：捕获当前模拟器屏幕并返回图像路径。

3. 应用程序实用工具

• 应用安装：将应用程序快速安装到指定设备或模拟器中。
• 日志记录：获取实时日志输出以帮助调试。

🔍 为什么需要 XcodeBuildMCP？

• 解决 Swift 宏问题：XcodeBuildMCP 默认启用跳过 Swift 宏验证的选项，以避免在使用 Swift Macros 的项目中出现错误。
• 自动化构建和测试：简化 Xcode 构建和测试流程，提升开发效率。

💻 使用示例

故障排除 - 诊断工具使用方法

# 使用 npm 运行诊断工具
npm run xcodebuildmcp-diagnostic@1.3.1

# 或者直接执行
xcodebuildmcp-diagnostic

工具功能

• 系统检查：验证 Node.js 和操作系统版本。
• Xcode 配置：检查 Xcode 安装路径和工具链状态。
• 依赖项检查：确认 idb、xcodebuild 等工具是否正确安装。

演示案例

1. 使用 Cursor 自动修复构建错误

2. 屏幕截图与 UI 自动化功能

3. 在 Claude Code 中构建和运行 iOS 应用

视频链接

🤝 贡献指南

如何贡献

1. 本地配置：

   • 克隆仓库。
   • 安装依赖项：npm install

2. 代码提交规范：

   • 遵循项目编码风格和文档标准。

3. 测试要求：

   • 在提交前运行单元测试，确保功能正常。

4. 问题报告：

   • 使用 GitHub 仓库的 Issue 跟踪和报告问题。

📄 许可证

XcodeBuildMCP 按照 MIT 许可证发布，具体内容请参阅 LICENSE 文件。