Xcode MCP Server

Xcode MCP Server是一个基于Model Context Protocol的服务器，为AI助手提供全面的Xcode集成功能，包括项目管理、文件操作、构建测试、CocoaPods和Swift包管理以及iOS模拟器工具等。

开发者工具操作系统自动化 #Xcode集成 #AI开发工具 #iOS开发 .TypeScript

评分 : 3.5分

下载量 : 229

更新时间 : 2025-04-28

什么是Xcode MCP服务器？

Xcode MCP服务器是一款专为AI助手设计的工具，它允许您通过标准化接口轻松管理Xcode项目、执行构建测试、操作文件以及控制iOS模拟器。

如何使用Xcode MCP服务器？

只需启动服务器并按照提示进行配置，即可开始使用。您可以创建新项目、添加文件、运行测试或管理模拟器。

适用场景

适用于开发者需要快速设置项目环境、调试应用或生成自动化报告的场景。

主要功能

项目管理支持创建、加载和操作标准Xcode项目、工作区及Swift包。

文件操作读取、写入文件，处理二进制数据，搜索特定内容。

构建与测试执行构建任务、运行测试并分析代码质量。

模拟器控制启动、关闭模拟器，安装应用并录制屏幕。

Swift包管理添加、移除依赖项并更新包。

优势与局限性

优势

强大的Xcode集成能力

支持多种项目类型

易于扩展的新工具集成

局限性

需要macOS系统支持

部分高级功能可能对初学者复杂

如何使用

安装Xcode MCP服务器

确保您的Mac已安装最新版本的Xcode，并运行安装脚本以完成所有依赖项的配置。

启动服务器

启动服务器后，AI助手可以开始调用您的Xcode项目。

配置权限

在配置文件中指定允许访问的目录，确保安全性和兼容性。

使用案例

创建新项目通过调用API创建一个全新的iOS应用项目。

运行测试执行项目中的单元测试并显示失败情况。

常见问题

为什么需要安装Xcode才能使用此服务器？

如何解决权限错误？

🚀 Xcode MCP 服务器使用说明

Xcode MCP 服务器是一个用于特定操作的服务器，支持工具注册与调用，可对文件操作进行路径验证和错误处理，还能进行自定义配置。

🚀 快速开始

注册工具

在 src/tools/ 目录下创建一个新的工具类别，并在其中注册工具：

// src/tools/build/index.ts
export const build = new Tool({
  name: 'build',
  description: 'Builds an Xcode project or workspace.',
  parameters: {
    // 定义参数 schema
  },
})

使用工具

通过发送 HTTP 请求来调用工具：

curl -X POST http://localhost:3000/tools/build \
     -H "Content-Type: application/json" \
     -d '{"parameter": "value"}'

✨ 主要特性

可配置性：支持配置允许目录和日志级别。
安全性：进行路径验证，将文件操作限制在允许的目录内，同时对工具执行进行错误处理。
扩展性：可以自定义工具分类和扩展日志记录。

📦 安装指南

请按照以下步骤安装 Xcode MCP 服务器：

克隆仓库

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

安装依赖
```
npm install
```
启动服务器
```
npm start
```

默认情况下，服务器将在 localhost:3000 上运行。

📚 详细文档

配置指南

配置允许目录

在项目根目录下创建一个 .env 文件：

ALLOWED_DIRS=/path/to/your/project/directory

配置日志级别

编辑 src/server.ts 文件，设置日志级别：

const logger = Logger({
  level: 'info', // 可选值：'debug'、'info'、'warn'、'error'
})

安全指南

路径验证

所有文件操作都会限制在允许的目录内：

const path = await validatePathAgainstAllowedDirs(filePath);

错误处理

工具执行时会捕获并记录错误信息：

try {
  // 执行工具逻辑
} catch (error) {
  logger.error(error.message);
}

高级主题

自定义工具分类

在 src/tools/ 目录下创建新的子目录，并在对应的 index.ts 文件中注册工具：

// src/tools/custom/index.ts
export const customTool = new Tool({
  name: 'custom',
  description: 'Custom Xcode operation.',
  parameters: {
    // 定义参数 schema
  },
})

扩展日志记录

自定义日志格式和输出：

const logger = Logger({
  format: ({ level, message }: { level: string; message: string }) =>
    `${new Date().toISOString()} [${level.toUpperCase()}] ${message}`,
});