MCP 服务器

Xcode MCP Server

将 Claude AI 与 Xcode 连接，从而在您的本地机器上安全地实现 AI 驱动的代码辅助、项目管理和自动化开发任务。

开发者工具

操作系统自动化

访问服务器

Tools

set_projects_base_dir

Set the base directory where Xcode projects are stored

set_project_path

Explicitly set the path to the Xcode project to work with

get_active_project

Get information about the currently active Xcode project

read_file

Read contents of a file in the Xcode project

write_file

Write or update contents of a file in the Xcode project

analyze_file

Analyze source file for issues and suggestions

build_project

Build the current Xcode project

run_tests

Run tests for the current Xcode project

list_project_files

List all files in an Xcode project

README

Xcode MCP 服务器

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

什么是 Xcode MCP 服务器？

从本质上讲，该服务器遵循客户端-服务器架构，其中 Claude 可以安全地与您的本地 Xcode 项目进行交互：

flowchart LR
    subgraph "您的计算机"
        Claude["Claude Desktop"]
        MCP["Xcode MCP 服务器"]
        XP[("Xcode 项目")]

        Claude <-->|"MCP 协议\n(命令 & 结果)"| MCP
        MCP <-->|"本地访问\n(文件 & 构建操作)"| 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. 从源代码

克隆此存储库：

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

安装依赖项：
```
npm install
```
设置环境变量：
```
cp .env.example .env
```
编辑 .env 并将 PROJECTS_BASE_DIR 设置为您的 Xcode 项目目录。
构建项目：
```
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"
      }
    }
  }
}