XcodeBuildMCP：简化AI与Xcode项目交互的利器

XcodeBuildMCP：简化AI与Xcode项目交互的利器

XcodeBuildMCP A Model Context Protocol (MCP) server that provides Xcode-related tools for integration with AI assistants and other MCP clients. 项目地址: https://gitcode.com/gh_mirrors/xc/XcodeBuildMCP

项目介绍

XcodeBuildMCP 是一个实现了 Model Context Protocol (MCP) 服务器功能的开源项目，它为 AI 助手和其他 MCP 客户端提供了与 Xcode 相关的工具。通过标准化接口，它优化了 Agent 驱动的开发工作流程中与 Xcode 项目的程序化交互。

使用 Cursor 构建并在 iOS 模拟器上安装和启动应用，同时捕获运行时日志。

项目技术分析

XcodeBuildMCP 服务器通过 MCP 协议暴露了 Xcode 操作作为工具，使得 Agent 可以通过标准化的方式调用这些工具。这种设计允许 Agent 无缝利用 Xcode 的功能，同时减少了配置错误的风险。

项目利用了现代的前端和后端技术，如 Node.js 和 TypeScript，确保了工具的灵活性和可扩展性。同时，项目通过提供一系列工具封装了 Xcode 的常见操作，使得 Agent 可以轻松地执行构建、部署、测试等任务。

项目技术应用场景

XcodeBuildMCP 的核心应用场景在于简化 AI 助手与 Xcode 项目的交互。以下是几个典型的使用场景：

1. 自动修复构建错误：Agent 可以通过 XcodeBuildMCP 检查和修复构建错误，提高开发效率。
2. 自动化构建和运行：Agent 可以自动构建和运行 iOS 应用，支持在模拟器或真实设备上执行。
3. 持续集成/持续部署 (CI/CD)：集成到 CI/CD 流程中，自动化测试和部署过程，确保代码质量。

项目特点

Xcode 项目管理

• 项目发现：自动发现 Xcode 项目和工作空间。
• 构建操作：支持 macOS、iOS 模拟器和 iOS 设备目标平台的具体构建工具。
• 项目信息：列出方案和显示构建设置。
• 清理操作：使用 xcodebuild 的原生清理操作清理构建产品。

模拟器管理

• 模拟器控制：列出、启动和打开 iOS 模拟器。
• 应用部署：在 iOS 模拟器上安装和启动应用。
• 日志捕获：从模拟器捕获运行时日志。
• UI 自动化（测试版）：与模拟器 UI 元素交互。
• 截图（测试版）：从模拟器捕获屏幕截图。

应用工具

• 包 ID 提取：从 iOS 和 macOS 应用包中提取包标识符。
• 应用启动：在模拟器和 macOS 上启动构建的应用。

开始使用

环境准备

• macOS 14.5 或更高版本
• Xcode 16.x 或更高版本
• mise 工具

一行命令安装 mise

# macOS (Homebrew)
brew install mise

更多关于 mise 的信息，请访问官方文档。

配置 MCP 客户端

在 MCP 客户端（如 Windsurf、Cursor、Claude Desktop 等）中添加以下配置：

{
  "mcpServers": {
    "XcodeBuildMCP": {
      "command": "mise",
      "args": [
        "x",
        "npm:xcodebuildmcp@1.3.0",
        "--",
        "xcodebuildmcp"
      ]
    }
  }
}

请注意，使用 mise 时避免使用 @latest 标签，因为 mise 可能会缓存包，并且不会自动更新到最新版本。

启用 UI 自动化（测试版）

启用 UI 自动化功能前，需要安装 Facebook 的 idb_companion：

brew tap facebook/fb
brew install idb-companion

安装 fb-idb Python 包：

pip install fb-idb==1.1.7

请注意，UI 自动化功能目前为测试版，可能会遇到一些问题。

实践案例

自动修复构建错误

利用新的 UI 自动化和屏幕捕获功能

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

XcodeBuildMCP 通过提供一系列实用的工具和功能，极大地简化了 AI 与 Xcode 项目的集成，提高了开发效率和代码质量。如果您正寻求自动化 iOS 开发流程，XcodeBuildMCP 绝对值得一试。

XcodeBuildMCP A Model Context Protocol (MCP) server that provides Xcode-related tools for integration with AI assistants and other MCP clients. 项目地址: https://gitcode.com/gh_mirrors/xc/XcodeBuildMCP