Xcode MCP 服务器

一个模型上下文协议（MCP）服务器，将 AI 的力量带到你的 Xcode 项目中。该服务器充当 Claude 和你本地的 Xcode 开发环境之间的桥梁，实现智能代码辅助、项目管理和自动化开发任务。

Xcode MCP 服务器是什么？

在核心上，这个服务器遵循客户端-服务器架构，使得 Claude 可以安全地与你的本地 Xcode 项目进行交互：

flowchart LR
    subgraph "Your Computer"
        Claude["Claude Desktop"]
        MCP["Xcode MCP Server"]
        XP[("Xcode Projects")]

        Claude <-->|"MCP Protocol\n(Commands & Results)"| MCP
        MCP <-->|"Local Access\n(File & Build Operations)"| XP
    end

Xcode MCP 服务器与你本地项目之间的通信完全发生在你的机器上——你的代码不会暴露到互联网。模型上下文协议确保 Claude 只能通过明确定义的接口执行批准的操作，为你提供一种安全的方式来让 AI 辅助开发，同时保持完全控制。

MCP 客户端兼容性

该服务器实现了模型上下文协议（MCP）规范，使其与任何符合 MCP 的客户端或主机兼容。虽然安装说明侧重于 Claude Desktop，但你可以使用以下工具：

• 自建的 MCP 客户端
• Cursor AI
• 其他符合 MCP 的 IDE 和工具
• 任何实现 MCP 客户端规范的应用程序

标准化的协议确保了不同客户端之间的一致功能，同时保持相同级别的安全性和仅限本地操作。

主要功能

🔍 智能项目检测

• 自动查找并连接到你的活动 Xcode 项目
• 支持手动选择项目以进行精确控制
• 在交互过程中保持工作区上下文

📁 智能文件操作

• 读取和分析 Swift、Objective-C 和项目配置文件
• 创建和修改带有正确语法和导入的源文件
• 智能文件列表，支持类型过滤和搜索

🛠 项目管理

• 访问项目目标、配置和方案
• 分析源文件以发现潜在问题
• 使用特定配置执行构建
• 运行和管理测试套件

安装

你可以通过三种方式安装此服务器：

1. 使用 NPM 包的 Claude Desktop

更新你的 Claude 配置文件 (~/Library/Application Support/Claude/claude_desktop_config.json)：

{
  "mcpServers": {
    "xcode": {
      "command": "npx",
      "args": [
        "-y",
        "xcode-mcp-server"
      ],
      "env": {
        "PROJECTS_BASE_DIR": "/path/to/your/xcode/projects"
      }
    }
  }
}

2. 全局 NPM 安装

全局安装包：

npm install -g @modelcontextprotocol/xcode-server

然后更新你的 Claude 配置：

{
  "mcpServers": {
    "xcode": {
      "command": "xcode-server",
      "env": {
        "PROJECTS_BASE_DIR": "/path/to/your/xcode/projects"
      }
    }
  }
}

3. 从源代码安装

1. 克隆此仓库：

   git clone https://github.com/r-huijts/xcode-mcp-server.git
   cd xcode-mcp-server
   

2. 安装依赖项：

   npm install
   

3. 设置环境变量：

   cp .env.example .env
   

   编辑 .env 并将 PROJECTS_BASE_DIR 设置为你的 Xcode 项目目录。

4. 构建项目：

   npm run build
   

然后更新你的 Claude 配置：

{
  "mcpServers": {
    "xcode": {
      "command": "node",
      "args": [
        "/absolute/path/to/xcode-mcp-server/dist/index.js"
      ],
      "env": {
        "PROJECTS_BASE_DIR": "/path/to/your/xcode/projects"
      }
    }
  }
}

注意：请将 /path/to/your/xcode/projects 替换为你实际的 Xcode 项目目录路径。

更新配置后，重启 Claude Desktop 使更改生效。

使用服务器

该服务器为 Claude 提供了一个自然的接口，以帮助你的 Xcode 开发。以下是一些你可以交互的方式：

项目导航

要求 Claude：

• "将我的 Xcode 项目目录设置为 /Users/username/Documents/XcodeProjects"
• "我当前的活动项目是什么？"
• "切换到 MyApp.xcodeproj 项目"
• "显示项目中的所有 Swift 文件"

代码创建与修改

获取帮助：

• "创建一个名为 ProfileView 的新视图并带有预览提供者"
• "在 UserModel.swift 中添加一个 @Published email 属性"
• "设置现代异步/等待网络层"
• "实现具有 SwiftUI 绑定的核心数据模型"

项目分析与构建

让 Claude 协助：

• "分析 NetworkManager.swift 中的潜在问题"
• "使用 Debug 配置构建项目"
• "运行 UserModel 模块的单元测试"
• "有哪些可用的构建方案？"

开发和调试

构建项目

npm run build

运行测试

npm test

故障排除

服务器通过 stderr 提供详细的日志记录。常见问题及其解决方案：

1. 项目检测问题

   • 验证你的项目目录路径
   • 确保已安装 Xcode 命令行工具
   • 检查文件权限

2. 构建问题

   • 验证 Xcode 安装
   • 检查项目配置
   • 查看构建设置

贡献

我们欢迎贡献！无论是：

• 🐛 修复 Bug
• ✨ 新功能
• 📚 文档改进
• 🧪 额外的测试

请随时提交 Pull Request。

许可证

本项目根据 MIT 许可证许可 - 详情请参阅 LICENSE 文件。