Xcode MCP Server

基本能力

产品定位

Xcode MCP Server 是一个专为LLM应用设计的服务，用于直接构建和测试Xcode项目，提供标准化的接口供AI助手使用。

核心功能

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

适用场景

• AI助手直接构建和测试Xcode项目
• 自动化构建和测试流程
• 实时监控构建和测试进度
• 获取详细的构建和测试报告

工具列表

build_project

构建Xcode项目，支持指定参数如项目路径、方案名称、配置等。

run_tests

运行单元测试，支持测试过滤和跳过特定测试。

常见问题解答

• 所有日志存储在指定的基础目录下的build-logs/中
• 构建操作会创建纯文本日志、JSON格式日志和Xcode报告
• 测试操作会创建测试日志、JSON格式日志、测试报告和代码覆盖率报告
• 最新日志可通过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