项目介绍

XcodeBuildMCP 是一个Model Context Protocol (MCP)服务器，提供与Xcode相关的工具，以便与AI助手和其他MCP客户端集成。它旨在通过标准化接口优化开发者工作流，使AI代理能够自动化Xcode项目的管理、构建和调试操作，从而提高效率并减少错误。

核心功能点

自动化开发流程：通过程序化接口替代手动Xcode命令行操作，减少人为错误。

增强AI代理能力：允许AI独立执行构建、测试、部署等任务，并实时获取反馈。

跨平台支持：覆盖macOS、iOS模拟器和真机设备的构建与调试。

详细功能介绍

Xcode 项目管理

• 支持多平台构建工具（macOS、iOS 模拟器和 iOS 设备）
• 项目和工作空间的构建设置查看
• 方案（schemes）列表查看
• 使用 xcodebuild 原生清理功能

2. 模拟器管理

• iOS 模拟器列表查看
• 模拟器启动和打开
• 应用程序安装到模拟器
• 在模拟器中启动应用

3. 应用程序实用工具

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

4. 操作进度追踪

• 长时间运行操作的实时反馈
• 构建阶段跟踪（编译、链接、代码签名）
• 操作状态监控
• 预估进度显示
• 错误信息报告

安装与配置

依赖安装：

# 使用Homebrew安装mise（可选加速）
brew install mise
# 或直接安装Node.js

一键部署（推荐）：

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

本地开发：

git clone https://github.com/cameroncooke/XcodeBuildMCP.git
cd XcodeBuildMCP
npm install && npm run build
node build/index.js

客户端配置示例

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

注意事项

• 权限要求：确保用户具有Xcode命令行工具的访问权限。
• 性能开销：长期运行的任务（如完整构建）可能消耗较高CPU/内存资源。
• 兼容性：仅支持macOS系统，因Xcode和模拟器依赖Apple生态。

#MCP #MCPServer #XcodeBuildMCP #IOS