xcf (Codefreezeai)

🚀 XCF Xcode MCP服务器

快速为您的AI工作流程充电！

  ](https://github.com/toddbruss/xcf) ](https://github.com/codefreezeai/xcf/releases) ](https://github.com/codefreezeai/xcf/stargazers) ](https://github.com/codefreezeai/xcf/network)

🖌️ 1.0.5中的新功能！

• ✅ 文件和目录操作
• ✅ 脚本桥Xcode文档操作
• ✅ 模糊逻辑路径解析
• ✅ Swift代码分析（无需在Xcode中构建）
• ✅ Xcode自动化的21个MCP工具

使用xcf加快Xcode应用程序的编写速度，xcf是一个非常简单的基于Swift的MCP服务器，专为Cursor、Claude Code和VSCode设计——没有TypeScript、没有JavaScript、没有BS！

🧰 XCF安装和配置

安装步骤

1. 下载XCF应用程序并将其拖动到您的/Applications文件夹中。
2. 启动应用程序以批准互联网下载。

1. 您将看到以下警报（这是预期的）：

1. 单击“按退出此XCF Xcode MCP服务器”按钮。

💡 故障排除： 如果XCF未显示警报，请运行以下命令： ``bash codesign --force --deep --sign - /Applications/xcf.app ``

您还可以使用Xcode从源代码构建xcf。它是100%Swift，易于在本地构建。

🔧 快速设置

最低要求：

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

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

配置位置

• 光标: ~/.cursor/mcp.json
• 克劳德桌面版: ~/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支持简化的、用户友好的代码段命令：

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

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_PATH定义的工作区文件夹中搜索
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个工具）

核心工具

项目管理工具

文件系统工具

代码分析工具

用于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 -更改后构建

基本工作流程（适用于人工智能助理）

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

代码分析工作流（适用于AI助手）

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

文件操作工作流（适用于AI助手）

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

📺 演示

观看XCF的动作： YouTube演示

❓ 故障排除

如果命令失败，请检查：

• xcf安装正确
• 刷新xcf MCP服务器
• 验证服务器是否启动并位于您的/Applications文件夹中
• 环境变量 env 例如“服务器”
• 重新启动您的AI助手

🤝 开源社区

欢迎Swift工程师投稿！帮助我们让xcf变得更好。

💯 100%Swift。100%开源。

______________________________________________________________________

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