XcodeBuildMCP

XcodeBuild MCP

一个模型上下文协议 (MCP) 服务器，提供与 Xcode 相关的工具，用于与 AI 助手和其他 MCP 客户端集成。

目录

• 概述
• 为什么？
• 特性
• 开始使用
  • 前提条件
  • 使用 mise x 一行命令设置
  • 配置 MCP 客户端
• 演示
  • 在 Cursor 中构建和运行 iOS 应用
  • 在 Claude Code 中构建和运行 iOS 应用
• 本地开发设置
  • 前提条件
  • 安装
  • 配置您的 MCP 客户端
  • 调试
• 许可证

概述

本项目实现了一个 MCP 服务器，该服务器将 Xcode 操作公开为工具，AI 代理可以通过 MCP 协议调用这些工具。它通过标准化的接口实现与 Xcode 项目的程序化交互，并针对代理驱动的开发工作流程进行了优化。

<caption>演示展示了 Claude Code 构建和启动 macOS 应用。</caption>

为什么？

XcodeBuild MCP 工具的主要目的是简化和标准化 AI 代理与 Xcode 项目之间的交互。通过为常见的 Xcode 操作提供专用工具，它消除了对手动或可能不正确的命令行调用的依赖。

这确保了可靠且高效的开发过程，使代理能够无缝地利用 Xcode 的功能，同时降低配置错误的风险。

至关重要的是，此 MCP 使 AI 代理能够通过构建项目、检查错误和自主迭代来独立验证代码更改。与 Sweetpad 等用户驱动的工具相比，XcodeBuild MCP 使代理能够有效地自动化这些工作流程。

特性

XcodeBuildMCP 服务器提供以下工具功能：

Xcode 项目管理

• 构建操作：用于 macOS、iOS 模拟器和 iOS 设备目标的平台特定构建工具
• 项目信息：用于列出方案并显示 Xcode 项目和工作区构建设置的工具
• 清理操作：使用 xcodebuild 的原生清理操作清理构建产品

模拟器管理

• 模拟器控制：列出、启动和打开 iOS 模拟器
• 应用部署：在 iOS 模拟器上安装和启动应用

应用实用工具

• Bundle ID 提取：从 iOS 和 macOS 应用包中提取 Bundle ID
• 应用启动：在模拟器和 macOS 上启动已构建的应用

操作进度

• 实时反馈：在长时间运行的操作期间获取详细的进度更新
• 构建阶段跟踪：监控编译、链接和代码签名阶段
• 状态报告：查看操作状态、估计进度和错误信息
• 了解更多关于进度更新的信息

开始使用

前提条件

• Xcode 命令行工具
• Node.js (v16 或更高版本)
• npm

[!NOTE] 如果您正在使用 mise，则可以跳过 Node.js 和 npm 安装步骤。

使用 mise x 一行命令设置

安装 mise:

# macOS (Homebrew)
brew install mise

# 其他安装方法
# 请参阅 https://mise.jdx.dev/getting-started.html

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

配置 MCP 客户端

通过添加以下配置，配置您的 MCP 客户端（Windsurf、Cursor、Claude Desktop 等）以使用 XcodeBuildMCP 服务器：

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

或者，如果您有现有的 Node.js 环境，则可以使用 npx 代替 mise：

{
  "mcpServers": {
    "XcodeBuildMCP": {
      "command": "npx",
      "args": [
        "xcodebuildmcp"
      ]
    }
  }
}

演示

在 Cursor 中构建和运行 iOS 应用

https://github.com/user-attachments/assets/b9d334b5-7f28-47fc-9d66-28061bc701b4

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

https://github.com/user-attachments/assets/e3c08d75-8be6-4857-b4d0-9350b26ef086

本地开发设置

前提条件

• Node.js (v16 或更高版本)
• npm
• Xcode 命令行工具

安装

1. 克隆存储库
2. 安装依赖项：

   npm install
   

3. 构建项目：

   npm run build
   

4. 启动服务器：

   node build/index.js
   

配置您的 MCP 客户端

要配置您的 MCP 客户端以使用本地 XcodeBuildMCP 服务器，请添加以下配置：

{
  "mcpServers": {
    "XcodeBuildMCP": {
      "command": "node",
      "args": [
        "/path_to/XcodeBuildMCP/build/index.js"
      ]
    }
  }
}

请记住，在对服务器实现进行更改后，您需要重建并重新启动服务器。

npm run build
node build/index.js

调试

您可以通过以下方式使用 MCP Inspector：

npx @modelcontextprotocol/inspector node build/index.js

许可证

本项目根据 MIT 许可证获得许可 - 有关详细信息，请参阅 LICENSE 文件。