xcf - AI-Powered Xcode Automation

🚀 XCF Xcode MCP 服务

🤖 由 Agent! 的创建者打造，这是一款自主 macOS Agent。

用 Swift 为你的 AI 工作流强力加速！

🖌️ 1.0.6 版更新内容

• 更精简的 MCP 服务，专注于 Xcode 项目自动化、文件读取、目录导航、Swift 分析和代码片段。
• 从 MCP 服务中移除了 diff、代码编辑和 Xcode 文档工具，以及 MultiLineDiff (D1F) 依赖项。
• 提供可下载的 DMG 和 ZIP 安装包，DMG 中附带 Applications 快捷方式，支持拖放安装。
• 通用 macOS 应用，支持 Apple 芯片和 Intel，最低要求为 macOS 13.5。
• 修复打包版本兼容性问题：将 xcf-swift 固定为 1.0.0，并将 MCP 调用点适配到更新后的 SDK。

升级： 对于从 XCF 中移除的操作，请使用客户端自带的编辑工具。替换应用并重启 MCP 客户端，以重新加载工具列表。

发行说明 · 1.0.5 以来的变更

使用 xcf 加快 Xcode 应用开发。xcf 是一款基于 Swift、极其简单的 MCP 服务，专为 Cursor、Claude Code 和 VSCode 设计——无需 TypeScript、无需 JavaScript、不搞复杂那一套！

🧰 XCF 安装与配置

下载

安装包	安装方式
XCF 1.0.6 — macOS DMG	推荐： 打开映像，将 xcf.app 拖到 Applications 快捷方式上。
XCF 1.0.6 — macOS ZIP	解压归档文件，并将 xcf.app 移至 /Applications。

打包应用的最低部署目标为 macOS 13.5，并已在 arm64 和 x86_64 可执行文件中验证。尚未在 macOS 13.5 上进行运行时测试。

安装步骤

1. 使用上方任一下载包安装 XCF。
2. 启动应用，以批准互联网下载。

3. 你将看到以下提醒（这是正常情况）：

4. 点击“按下以退出此 XCF Xcode MCP 服务”按钮。

💡 故障排查： 如果 XCF 没有显示提醒，请运行此命令：

codesign --force --deep --sign - /Applications/xcf.app

你也可以使用 Xcode 从源代码构建 xcf。

源代码归档说明： 附带的 1.0.6 应用安装包包含在 1.0.6 标签创建后加入的兼容性修复。GitHub 为该标签自动生成的源代码归档不包含这些修复。

🔧 快速设置

最低要求：

• 打包应用需要 macOS 13.5 或更高版本。
• 使用 Xcode 项目自动化需要 Xcode。
• 配置为通过标准输入/输出启动 XCF 的 MCP 客户端。

将 xcf 添加到你的 MCP 配置文件中：

{
  "mcpServers": {
    "xcf": {
      "type": "stdio",
      "command": "/Applications/xcf.app/Contents/MacOS/xcf",
      "args": ["server"]
    }
  }
}          

配置位置

• Cursor：~/.cursor/mcp.json
• Claude Desktop：~/Library/Application Support/Claude/claude_desktop_config.json

⚠️ 重要： 设置完成后，请重启 AI 助手或刷新工具。

⚙️ 高级配置

对于非 Cursor 客户端或需要严格控制项目级配置的用户：

{
  "mcpServers": {
    "xcf": {
      "type": "stdio",
      "command": "/Applications/xcf.app/Contents/MacOS/xcf",
      "args": ["server"],
      "env": {
          "XCODE_PROJECT_FOLDER": "/path/to/project/",
          "XCODE_PROJECT": "/path/to/project/project.xcodeproj"
      }
    }
  }
}

这些环境变量可以帮助你：

• 预先选择要使用的特定 Xcode 项目
• 定义自定义工作区边界以确保安全

✨ 主要功能

• 零依赖： 安装简便，无需依赖其他 MCP 服务
• 自动检测项目： 自动选择你的 Xcode 项目，让你立即开始编码
• 实时错误处理： xcf build 或 xcf run 会将 Xcode 中的错误和警告直接发送到你的 AI IDE
• AI 驱动的修复： 让 Claude 在编码过程中修复 Bug 和错误
• 直观的命令： 简单、便于开发者使用的命令结构，助力提高工作效率
• 全面的文件操作： 轻松读取文件和目录
• Xcode 集成： 直接构建、运行和管理 Xcode 项目
• 高级代码分析： 无需在 Xcode 中构建，即可详细分析 Swift 代码

🛠️ 专为 Swift 开发者打造

此工具由 Swift 开发者为 Swift 开发者打造。build、run、show 等命令以及新增的文件和目录操作，让工作流直观而自然。

📋 命令参考

xcf 命令	操作说明
show	列出已打开的 Xcode 项目
open #	按编号选择项目
run	运行当前项目
build	构建当前项目
current	显示已选项目
env	显示环境变量
pwd	显示当前文件夹（别名：dir、path）
help	显示所有可用命令

文件操作

命令	说明
read_file <file>	读取文件内容
read_dir [path] [extension]	列出目录内容
cd_dir <path>	切换目录

分析工具

命令	说明
snippet <file> [start] [end]	提取代码片段
analyzer <file> [start] [end]	分析 Swift 代码
lz <file>	analyzer 的简写

📄 使用代码片段

用于人工命令

xcf 支持简化且易于使用的代码片段命令：

要获取整个文件，只需使用文件名：

xcf snippet filename.swift

很多情况下无需使用完整路径，xcf 会智能地查找并显示完整文件内容。

指定行范围：

xcf snippet filename.swift 10 20

文件操作可以使用以下任一格式：

xcf snippet /path/to/file.swift                 // Direct path
xcf snippet filePath=/path/to/file.swift        // Named parameter

xcf analyze /path/to/file.swift                 // Direct path
xcf analyze filePath=/path/to/file.swift        // Named parameter

xcf lz /path/to/file.swift                      // Direct path (shorthand)
xcf lz filePath=/path/to/file.swift             // Named parameter (shorthand)

指定行范围：

xcf snippet /path/to/file.swift 10 20           // Direct path with line range
xcf snippet filePath=/path/to/file.swift startLine=10 endLine=20  // Named parameters

用于 AI 助手

通过 MCP 工具使用 xcf 时，请使用以下语法：

mcp_xcf_snippet filePath="filename.swift" entireFile=true

指定行范围：

mcp_xcf_snippet filePath="filename.swift" startLine=10 endLine=20

智能路径解析

如果在确切路径下找不到文件，xcf 会智能地在以下位置搜索：

1. 首先尝试提供的确切路径
2. 使用当前工作目录解析相对路径
3. 在当前项目目录及其上一级目录中搜索
4. 在 WORKSPACE_FOLDER_PATHS 定义的工作区文件夹中搜索
5. 在工作区文件夹中进行有限深度的递归搜索
6. 最后，模糊搜索相似的文件名

xcf 的所有文件操作都会一致地使用此智能路径解析功能，包括：

• 文件读取和代码片段
• 代码分析
• 目录操作

这意味着通常只需提供文件名，无需提供任何路径即可执行操作：

xcf snippet Constants.swift    // For humans
xcf analyze Constants.swift    // For humans

AI 助手也可以这样使用：

mcp_xcf_snippet filePath="Constants.swift" entireFile=true
mcp_xcf_analyzer filePath="Constants.swift" entireFile=true

🔍 Swift 代码分析

用于人工命令

分析整个 Swift 文件，查找潜在问题：

xcf analyze filename.swift

或使用简写形式：

xcf lz filename.swift

指定行范围：

xcf analyze filename.swift --startLine 10 --endLine 50

面向 AI 助手

通过 MCP 工具使用 xcf 时，请使用以下语法：

mcp_xcf_analyzer filePath="filename.swift" entireFile=true

或者使用简写形式：

mcp_xcf_xcf action="lz filename.swift"

指定行范围：

mcp_xcf_analyzer filePath="filename.swift" startLine=10 endLine=50

分析会识别以下问题：

• 代码风格和格式问题
• 复杂度较高的函数
• 未使用的变量和符号
• 魔法数字
• 过长的方法
• 以及更多问题

🧩 MCP 工具（21 个）

核心工具

工具	描述
xcf	执行 xcf 操作（show、open、build、run、current、env、pwd、analyze、lz）
list	列出此服务上所有可用的工具
xcf_help	仅提供 xcf 操作的快速帮助
help	提供包含常见示例的常规帮助
use_xcf	激活 XCF 模式
tools	显示所有工具的详细参考，包括 AI 函数调用
show_help	显示有关可用命令的帮助信息

项目管理工具

工具	描述
build_project	构建当前 Xcode 项目
run_project	运行当前 Xcode 项目
list_projects	列出所有已打开的 Xcode 项目
select_project	根据编号选择 Xcode 项目
show_current_project	显示当前所选项目的信息
show_env	显示所有环境变量
show_folder	显示当前工作文件夹
grant_permission	授予 Xcode 自动化权限

文件系统工具

工具	描述
read_file	读取文件内容
read_dir	列出目录内容
cd_dir	更改当前目录

代码分析工具

工具	描述
snippet	从文件中提取代码片段
analyzer	分析 Swift 代码中的潜在问题
analyze_swift_code	使用可自定义的检查组（syntax、style、safety、performance、bestPractices）分析 Swift 代码

用于 AI 函数调用

获取整个文件：

mcp_xcf_snippet(filePath="/full/path/to/file.swift", entireFile=true)

指定行范围：

mcp_xcf_snippet(filePath="/full/path/to/file.swift", startLine=10, endLine=20)

分析整个文件：

mcp_xcf_analyzer(filePath="/full/path/to/file.swift", entireFile=true)

指定行范围：

mcp_xcf_analyzer(filePath="/full/path/to/file.swift", startLine=10, endLine=50)

使用文件和目录

读取文件：

mcp_xcf_read_file filePath="main.swift"

列出目录内容：

mcp_xcf_read_dir directoryPath="."

仅列出 Swift 文件：

mcp_xcf_read_dir directoryPath="src" fileExtension="swift"

更改目录：

mcp_xcf_cd_dir directoryPath="src"

🔒 安全功能

• 可在指定工作区中安全地处理项目
• 自动阻止访问工作区边界之外的内容
• 必要时重定向到安全替代方案
• 使用环境变量定义安全边界

🔄 工作流示例

基本工作流（面向用户）

1. xcf show - 查看可用项目
2. xcf open 1 - 选择一个项目
3. xcf build - 构建项目
4. xcf run - 运行项目

代码分析工作流（面向用户）

1. xcf current - 检查当前项目
2. xcf snippet filename.swift - 检查代码
3. xcf lz filename.swift - 分析代码
4. xcf build - 修复问题后构建

文件操作工作流（面向用户）

1. read_dir . - 列出当前目录中的文件
2. read_file main.swift - 查看文件内容
3. 使用 Agent 原生工具编辑文件
4. xcf build - 更改后构建

基本工作流（面向 AI 助手）

2. mcp_xcf_xcf action="show" - 查看可用项目
3. mcp_xcf_xcf action="open 1" - 选择一个项目
4. mcp_xcf_xcf action="build" - 构建项目
5. mcp_xcf_xcf action="run" - 运行项目

代码分析工作流（面向 AI 助手）

2. mcp_xcf_xcf action="current" - 检查当前项目
3. mcp_xcf_snippet filePath="filename.swift" entireFile=true - 检查代码
4. mcp_xcf_analyzer filePath="filename.swift" entireFile=true - 分析代码
5. mcp_xcf_xcf action="build" - 修复问题后构建

文件操作工作流（面向 AI 助手）

2. mcp_xcf_read_dir directoryPath="." - 列出当前目录中的文件
3. mcp_xcf_read_file filePath="main.swift" - 查看文件内容
4. 使用 Agent 原生的 edit_file 工具编辑文件
5. mcp_xcf_xcf action="build" - 更改后构建

📺 演示

观看 XCF 的实际演示：YouTube 演示

❓ 故障排除

如果命令失败，请检查：

• xcf 是否正确安装
• 刷新 xcf MCP 服务
• 确认服务已启动且位于 /Applications 文件夹中
• 使用 env 检查环境变量，例如“server”
• 重新启动 AI 助手

🤝 开源社区

欢迎 Swift 工程师参与贡献！助力我们让 xcf 变得更好。

💯 100% Swift。100% 开源。

GitHub 仓库

---

由 XCodeFreeze Automation 和 CodeFreeze.ai 创建——将 Swift 开发的未来带到你指尖！

---

AgentiLoop： agentiloop.ai

版权所有 © 2026 AgentiLoop.ai，Logos InkPen LLC 旗下公司。保留所有权利。