Table of contents
2025.04.15
124
TypeScriptXcode 工具iOS 开发自动化构建开发效率
XcodeBuildMCP 是一个基于 Model Context Protocol (MCP) 的服务，旨在为 AI 助手和其他 MCP 客户端提供与 Xcode 相关的工具。它通过标准化的接口实现与 Xcode 项目的程序化交互，优化了由 AI 驱动的开发工作流程。该服务的主要功能包括 Xcode 项目管理、模拟器管理和应用实用工具，适用于需要自动化构建、测试和部署 iOS/macOS 应用的场景。
View on GitHub
Overview
基本能力
产品定位
XcodeBuildMCP 是一个为 AI 助手和 MCP 客户端设计的服务，用于标准化和自动化 Xcode 项目的构建和管理流程。
核心功能
- Xcode 项目管理：
- 构建操作（macOS、iOS 模拟器和设备目标）
- 项目信息（列出方案和显示构建设置）
- 清理操作（使用 xcodebuild 清理构建产物）
- 模拟器管理：
- 模拟器控制（列出、启动和打开 iOS 模拟器）
- 应用部署（在模拟器上安装和启动应用）
- 应用实用工具：
- 提取应用的 Bundle ID
- 在模拟器和 macOS 上启动应用
适用场景
- AI 助手驱动的自动化开发流程
- 需要频繁构建和测试 iOS/macOS 应用的场景
- 自动化部署和调试 iOS 模拟器应用
工具列表
- Build Operations：支持 macOS、iOS 模拟器和设备的构建工具
- Project Information：列出 Xcode 项目的方案和构建设置
- Clean Operations：清理构建产物
- Simulator Control：管理 iOS 模拟器
- App Deployment：在模拟器上安装和启动应用
- Bundle ID Extraction：从应用包中提取 Bundle ID
- App Launching：启动应用
常见问题解答
- 需要安装 Xcode 命令行工具和 Node.js（v16 或更高版本）
- 可以使用 mise 或 npx 快速安装和配置
使用教程
使用依赖
- Xcode 命令行工具
- Node.js（v16 或更高版本）
- npm
安装 Xcode 命令行工具：
xcode-select --install
安装 Node.js 和 npm（如果未使用 mise）：
# 使用 Homebrew（macOS）
brew install node
安装教程
- 使用 mise 安装（推荐）：
bash # 安装 mise brew install mise # 配置 MCP 客户端 - 使用 npx 安装：
bash npx xcodebuildmcp - 本地开发安装：
bash git clone <repository_url> cd XcodeBuildMCP npm install npm run build node build/index.js
调试方式
使用 MCP Inspector 调试：
npx @modelcontextprotocol/inspector node build/index.js