关键词

XcodeSwift开发AI代码助手IDE集成

XCF Xcode MCP服务器

项目简介

XCF（XCodeFreeze）是一个用纯Swift编写的MCP（Model Context Protocol）服务器，专门用于与AI代码助手（如Cursor, Claude Desktop, VSCode等）集成。它使得AI能够理解并操作Xcode项目，加速Swift应用的开发工作流程。

主要功能点

  • 自动化项目检测: 自动识别并选择当前Xcode项目。
  • 实时错误反馈: 将Xcode的构建和运行错误、警告直接发送给AI。
  • AI驱动的代码修复: 支持AI根据错误信息提出并应用修复建议。
  • 便捷的项目操作: 通过简单的命令执行Xcode的构建（build）和运行（run）操作。
  • 智能代码片段访问: 支持AI通过文件名或指定行号范围获取项目中的代码文件内容，并能智能解析文件路径。
  • 安全的工作空间: 限定AI操作范围，仅限于指定的工作空间内。

安装步骤

XCF 是一个 Swift 项目，通常会被构建成一个可执行的应用。具体的安装步骤可能因版本和发布方式而异，但一旦安装完成（例如安装到 '/Applications' 目录），AI客户端就可以通过指向其可执行文件的路径来与其建立连接。

服务器配置

MCP服务器是由支持MCP协议的AI客户端进行配置和启动的。以下是配置XCF服务器到AI客户端的典型信息结构（请参考AI客户端的文档进行具体配置）：

  • 服务器名称 (server name): 用户定义的名称，例如 'xcf'，用于在客户端中引用该服务器。
  • 连接类型 (type): 指定客户端与服务器的通信方式，对于XCF通常是 'stdio'（标准输入输出）。
  • 命令 (command): 服务器可执行文件的完整路径，例如 '/Applications/xcf.app/Contents/MacOS/xcf'。
  • 可选参数 (args): 启动服务器时传递的命令行参数（XCF的默认配置通常不需要额外参数）。
  • 可选环境变量 (env): 可以设置特定的环境变量来定制服务器行为，例如：
    • 'XCODE_PROJECT_FOLDER': 指定Xcode项目所在的根目录，限定AI的操作范围。
    • 'XCODE_PROJECT': 直接指定要使用的Xcode项目文件路径（'.xcodeproj' 或 '.xcworkspace'）。

配置示例（JSON格式，由客户端读取，用户无需手动创建此文件）：

{
  "mcpServers": {
    "xcf": {
      "type": "stdio", // 连接类型：标准输入输出
      "command": "/Applications/xcf.app/Contents/MacOS/xcf", // XCF服务器可执行文件路径
      "env": { // 可选环境变量
          "XCODE_PROJECT_FOLDER": "/path/to/your/swift/project/", // 指定项目根目录
          "XCODE_PROJECT": "/path/to/your/swift/project/YourApp.xcodeproj" // 直接指定项目文件
      }
    }
  }
}

注意: 上述配置信息应在您的AI客户端的MCP配置文件中添加，具体位置请参考AI客户端文档。配置修改后通常需要重启AI客户端才能生效。

基本使用方法

一旦配置并启动了XCF MCP服务器，您的AI助手就可以与其交互，例如：

  1. 激活XCF模式: 在AI对话中输入类似于 'use xcf' 的命令（具体取决于AI客户端的界面或提示）。
  2. 列出项目: 使用 'show' 命令查看当前工作空间中的可用Xcode项目。
  3. 选择项目: 使用 'open #' 命令（#为项目编号）选择一个项目进行操作。
  4. 构建项目: 使用 'build' 命令触发Xcode构建。
  5. 运行项目: 使用 'run' 命令运行当前选中的项目。
  6. 获取文件内容: 让AI调用 'snippet filename.swift' 命令来获取指定文件的完整代码内容。您也可以使用带路径和行号的更详细命令，但通常只使用文件名即可。
  7. 执行XCF工具: AI助手可以通过 MCP 的Function Call 能力调用暴露的工具，例如 'mcp_xcf_snippet(...)' 来获取代码片段。

AI客户端会通过JSON-RPC与XCF服务器通信，发送请求并接收响应（如命令执行结果、错误信息或代码片段）。

信息

分类

开发者工具

访问项目