基本能力
产品定位
Xcode MCP Server 是一个专为 Xcode 开发者设计的 AI 辅助工具,通过 MCP 协议实现智能代码生成、项目管理和自动化任务。
核心功能
- 智能项目检测:自动发现并连接到活动的 Xcode 项目,支持手动选择项目。
- 智能文件操作:读取、分析和修改 Swift、Objective-C 及项目配置文件。
- 项目管理:访问项目目标、配置和方案,执行构建和测试管理。
适用场景
- 需要 AI 辅助的 Xcode 开发者
- 自动化代码生成和修改
- 项目构建和测试管理
使用教程
使用依赖
确保已安装 Node.js 和 npm。
安装教程
- 使用 Claude Desktop 和 NPM 包
-
更新 Claude 配置文件 (
~/Library/Application Support/Claude/claude_desktop_config.json
):
json
{
"mcpServers": {
"xcode": {
"command": "npx",
"args": [
"-y",
"xcode-mcp-server"
],
"env": {
"PROJECTS_BASE_DIR": "/path/to/your/xcode/projects"
}
}
}
} -
全局 NPM 安装
bash
npm install -g @modelcontextprotocol/xcode-server
然后更新 Claude 配置文件。 -
从源代码安装
bash
git clone https://github.com/r-huijts/xcode-mcp-server.git
cd xcode-mcp-server
npm install
cp .env.example .env
npm run build
然后更新 Claude 配置文件。
调试方式
- 构建项目
bash
npm run build - 运行测试
bash
npm test - 常见问题
- 项目检测问题:检查项目目录路径和文件权限。
- 构建问题:验证 Xcode 安装和项目配置。