Xcode MCP Server

Xcode MCP Server

site icon
2025.04.17 159
TypeScript代码辅助项目管理自动化开发开发效率
Xcode MCP Server 是一个基于模型上下文协议(MCP)的服务器,旨在为 Xcode 项目提供 AI 辅助开发功能。它作为 Claude 与本地 Xcode 开发环境之间的桥梁,支持智能代码辅助、项目管理和自动化开发任务。该服务器遵循客户端-服务器架构,确保所有操作都在本地进行,保障代码安全。
View on GitHub

Overview

基本能力

产品定位

Xcode MCP Server 是一个专为 Xcode 开发者设计的 AI 辅助工具,通过 MCP 协议实现智能代码生成、项目管理和自动化任务。

核心功能

  • 智能项目检测:自动发现并连接到活动的 Xcode 项目,支持手动选择项目。
  • 智能文件操作:读取、分析和修改 Swift、Objective-C 及项目配置文件。
  • 项目管理:访问项目目标、配置和方案,执行构建和测试管理。

适用场景

  • 需要 AI 辅助的 Xcode 开发者
  • 自动化代码生成和修改
  • 项目构建和测试管理

使用教程

使用依赖

确保已安装 Node.js 和 npm。

安装教程

  1. 使用 Claude Desktop 和 NPM 包
  2. 更新 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" } } } }

  3. 全局 NPM 安装 bash npm install -g @modelcontextprotocol/xcode-server 然后更新 Claude 配置文件。

  4. 从源代码安装 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 安装和项目配置。

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。