Xcode MCP Server

基本能力

产品定位

Xcode MCP Server 是一个为 LLM 应用提供直接构建 Xcode 项目的 Model Context Protocol 服务器。

核心功能

• 使用自定义方案和配置构建 Xcode 项目
• 运行单元测试，支持精细控制（运行特定测试或跳过测试）
• 生成代码覆盖率报告
• 实时流式传输构建和测试日志
• 访问详细的构建和测试报告
• JSON 格式输出
• 自动日志持久化

适用场景

• 通过 AI 助手自动化构建和测试 Xcode 项目
• 实时监控构建和测试进度
• 生成详细的构建和测试报告

工具列表

1. build_project
2. 功能：使用指定参数构建 Xcode 项目

3. 参数：

   • projectPath（必需）：.xcodeproj 或 .xcworkspace 的路径
   • scheme（必需）：构建方案名称
   • configuration（可选）：构建配置（Debug/Release，默认为 Debug）
   • destination（可选）：构建目标（默认为 "platform=iOS Simulator,name=iPhone 15 Pro"）

4. run_tests

5. 功能：运行单元测试，支持可选过滤
6. 参数：
   • projectPath（必需）：.xcodeproj 或 .xcworkspace 的路径
   • scheme（必需）：测试方案名称
   • testIdentifier（可选）：要运行的特定测试（例如 'MyTests/testExample'）
   • skipTests（可选）：要跳过的测试标识符数组
   • configuration（可选）：构建配置（Debug/Release，默认为 Debug）
   • destination（可选）：测试目标（默认为 "platform=iOS Simulator,name=iPhone 15 Pro"）

常见问题解答

• 日志存储位置：所有日志存储在指定的基础目录下的 build-logs/ 文件夹中
• 构建操作会创建：
• 纯文本日志（build-[timestamp].log）
• JSON 格式日志（build-[timestamp].log.json）
• Xcode 报告（report-[timestamp].txt）
• 测试操作会创建：
• 测试日志（test-[timestamp].log）
• JSON 格式日志（test-[timestamp].log.json）
• 测试报告（test-report-[timestamp].txt）
• 代码覆盖率报告（coverage-[timestamp].txt）
• 最新日志（构建或测试）可通过 xcode-build://latest-log 资源访问

使用教程

使用依赖

• Node.js 16+
• Xcode Command Line Tools
• TypeScript
• MCP 兼容的客户端（例如 Claude Desktop）

安装教程

# 克隆仓库
git clone https://github.com/PolarVista/Xcode-mcp-server.git
cd xcode-mcp-server

# 安装依赖
npm install

# 构建服务器
npm run build

调试方式

1. 启动服务器： bash npm run start /path/to/build/logs/directory

2. 在 Claude Desktop 设置中配置： "xcode-build": { "command": "node", "args": ["/path/to/the/xcode-mcp-server/build/index.js", "/path/to/your/project/folder"], "env": { "PATH": "/usr/bin:/bin:/usr/local/bin:/usr/sbin:/sbin" } }

许可证

None