Xcode MCP 服务器

Name: Xcode MCP Server
Author: PolarVista

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

特征

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

Related MCP server: Xcode MCP Server

要求

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

安装

# Clone the repository git clone https://github.com/PolarVista/Xcode-mcp-server.git cd xcode-mcp-server # Install dependencies npm install # Build the server npm run build

与 Claude Desktop 一起使用

启动服务器：
npm run start /path/to/build/logs/directory
在 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" }

可用工具

构建项目

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

参数：

projectPath （必需）：.xcodeproj 或 .xcworkspace 的路径
scheme （必填）：构建方案名称
configuration （可选）：构建配置（调试/发布，默认为调试）
destination （可选）：构建目标（默认为“platform=iOS Simulator,name=iPhone 15 Pro”）

Claude 中的用法示例：

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

运行测试

运行带有可选过滤的单元测试。

参数：

projectPath （必需）：.xcodeproj 或 .xcworkspace 的路径
scheme （必填）：测试方案名称
testIdentifier （可选）：要运行的特定测试（例如，“MyTests/testExample”）
skipTests （可选）：要跳过的测试标识符数组
configuration （可选）：构建配置（调试/发布，默认为调试）
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资源访问