项目简介

Xcode MCP Server 是一个基于 Model Context Protocol (MCP) 的服务器，旨在将人工智能的强大功能引入您的 Xcode 项目。它充当 Claude 桌面应用与本地 Xcode 开发环境之间的桥梁，使 Claude 能够安全地与您的 Xcode 项目进行交互，提供智能代码辅助、项目管理和自动化开发任务等功能。所有通信和操作都在本地计算机上进行，确保代码安全。

主要功能点

智能项目检测: 自动检测并连接到您当前活跃的 Xcode 项目，支持手动选择项目，并保持工作区上下文。
智能文件操作: 读取和分析 Swift、Objective-C 以及项目配置文件；创建和修改源代码文件，并能正确处理语法和导入；智能文件列表功能，支持按类型过滤和搜索。
项目管理: 访问项目 targets、configurations 和 schemes；分析源代码文件以发现潜在问题；执行特定配置的构建；运行和管理测试套件。

安装步骤

安装 Node.js: 确保您的系统已安装 Node.js (v14 或更高版本)。
安装 Xcode Command Line Tools: 确保已安装 Xcode 命令行工具。
安装 TypeScript: 虽然不是必须手动安装，但构建过程依赖 TypeScript，通常 npm install 会自动处理。
安装 Claude 桌面应用: 确保您已安装支持 MCP 的 Claude 桌面应用。

克隆仓库:

git clone [repository-url]  # 请替换为仓库的实际 URL，例如：https://github.com/r-huijts/xcode-mcp-server
cd xcode-mcp-server

安装依赖:
```
npm install
```
构建项目:
```
npm run build
```

服务器配置

打开 Claude 桌面应用的配置文件 '~/Library/Application Support/Claude/claude_desktop_config.json' (如果文件不存在则创建)，添加以下 JSON 配置到 'mcpServers' 字段中：

{
  "mcpServers": {
    "xcode-server": {
      "command": "node",
      "args": [
        "/path/to/xcode-server/build/index.js"  // 请替换为您的 xcode-server 项目 build 目录下的 index.js 文件的绝对路径
      ],
      "env": {
        "PROJECTS_BASE_DIR": "/path/to/your/xcode/projects" // 可选：您的 Xcode 项目存放的根目录，用于自动检测项目，请替换为您实际的项目目录的绝对路径
      }
    }
  }
}

配置参数说明:

server name: 'xcode-server' (服务器名称，在 Claude 桌面应用中用于标识和选择此服务器)
command: 'node' (启动服务器的命令，这里使用 Node.js 运行)
args: '["/path/to/xcode-server/build/index.js"]' (命令参数，指定服务器入口文件 'index.js' 的绝对路径)
env.PROJECTS_BASE_DIR: (可选) Xcode 项目的根目录。如果设置，服务器将在此目录下搜索 Xcode 项目，方便自动检测和管理。

基本使用方法

配置完成后，在 Claude 桌面应用中选择 'xcode-server' 作为 MCP 服务器。您可以通过自然语言指令与 Claude 互动，让它协助您进行 Xcode 开发，例如：

项目导航:
- "设置我的 Xcode 项目目录为 '/Users/username/Documents/XcodeProjects'"
- "当前活跃的项目是什么？"
- "切换到 MyApp.xcodeproj 项目"
- "显示项目中所有的 Swift 文件"
代码创建与修改:
- "创建一个名为 ProfileView 的新视图，并包含预览 provider"
- "在 UserModel.swift 中添加一个 @Published 的 email 属性"
- "搭建一个现代的 async/await 网络层"
- "使用 SwiftUI 绑定实现 Core Data 模型"
项目分析与构建:
- "分析 NetworkManager.swift 文件，查找潜在问题"
- "以 Debug 配置构建项目"
- "运行 UserModel 模块的单元测试"
- "有哪些可用的构建 schemes？"

通过以上指令，您可以利用 Claude 和 Xcode MCP Server 提高 Xcode 开发效率。

关键词

项目简介

主要功能点

安装步骤

服务器配置

基本使用方法

信息