Polarvista Xcode MCP Server

🚀 Xcode MCP 服务器

Xcode MCP 服务器是一个用于直接从大语言模型应用程序构建和测试 Xcode 项目的 Model Context Protocol 服务器。它提供标准化接口，让 AI 助手能直接触发构建、运行测试、监控进度并访问日志。

🚀 快速开始

Xcode MCP 服务器提供了一个 Model Context Protocol 接口，可用于构建和测试 Xcode 项目。通过该接口，AI 助手能直接触发构建、运行测试、监控进度并访问日志。

✨ 主要特性

• 使用自定义方案和配置构建 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 设置中

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

可用工具

build_project

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

参数：

• projectPath（必填）：.xcodeproj 或 .xcworkspace 文件的路径
• 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（必填）：测试方案名称
• 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 报告（build-[timestamp].xcresult）
• 测试操作创建：
  • 纯文本日志（test-[timestamp].log）
  • JSON 格式日志（test-[timestamp].log.json）
  • Xcode 报告（test-[timestamp].xcresult）

您可以通过以下 URL 访问最新的构建和测试结果：

http://localhost:8080