Xcode MCP 服务器

<p align="center"> <strong>一个模型上下文协议服务器，用于直接从 LLM 应用程序构建 Xcode 项目</strong> </p>

Xcode MCP 服务器提供了一个模型上下文协议接口，用于构建和测试 Xcode 项目。它使 AI 助手能够通过标准化的接口直接触发构建、运行测试、监控进度和访问日志。

功能

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

要求

• Node.js 16+
• Xcode 命令行工具
• TypeScript
• 兼容 MCP 的客户端（例如，Claude Desktop）

安装

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

# 安装依赖
npm install

# 构建服务器
npm run build

与 Claude Desktop 一起使用

1. 启动服务器：

   npm run start /path/to/build/logs/directory
   

2. 在 Claude Desktop 设置中：

          "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"
      }
   

可用工具

build_project

使用指定的参数构建 Xcode 项目。

参数：

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

在 Claude 中的使用示例：

build_project({
  projectPath: "/path/to/Project.xcodeproj",
  scheme: "MyApp",
  configuration: "Debug"
})

run_tests

运行单元测试，可以选择过滤。

参数：

• projectPath (必需): .xcodeproj 或 .xcworkspace 的路径
• scheme (必需): 测试 scheme 名称
• testIdentifier (可选): 要运行的特定测试（例如，'MyTests/testExample'）
• skipTests (可选): 要跳过的测试标识符数组
• configuration (可选): 构建配置（Debug/Release，默认为 Debug）
• destination (可选): 测试目标（默认为 "platform=iOS Simulator,name=iPhone 15 Pro"）

在 Claude 中的使用示例：

run_tests({
  projectPath: "/path/to/Project.xcodeproj",
  scheme: "MyAppTests",
  testIdentifier: "LoginTests/testSuccessfulLogin",
  skipTests: ["PerformanceTests/testLargeDataLoad"],
  configuration: "Debug"
})

日志

• 所有日志都存储在指定的根目录下的 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 资源访问最新的日志（构建或测试）