Xcode MCP Server - XCF - XCodeFreeze Automation

Swift Xcode MCP Server

Come on in We're Open

Powered by Swift and Open Source, XCF captures build errors and warnings with precise line numbers and code snippets, giving AI assistants everything they need to fix issues automatically.

It is with great excitement that we introduce XCF - a powerful tool designed to bridge the gap between your AI assistants and Xcode. Built with 100% Swift for perfect integration with the Apple development ecosystem.

XCF provides seamless AI integration, working with Cursor, VSCode, and Claude Desktop. Simple commands let your AI assistant navigate, build, and run Xcode projects without leaving your chat.

Full Swift file code analysis without having to build using Xcode is coming soon!

See XCF in Action

AI-powered Xcode automation in action.

Streamlined Workflow

XCF was designed to make working with Xcode and AI assistants as smooth as possible. With a simple set of commands, you can unlock powerful automation capabilities that will transform your development process.

For developers working on complex projects, XCF provides the perfect bridge between advanced AI capabilities and Apple's development environment, saving countless hours of manual work.

Built with 100% Swift - Native performance and perfect integration with the Apple ecosystem
Intelligent Error Handling - Automatically fix warnings and errors with AI assistance
Simple Chat Commands - Control Xcode projects directly through your AI assistant
Build & Run Automation - Test your code without leaving your conversation
Multi-Project Support - Work across different Xcode projects in the same workspace

We believe that XCF represents a significant advancement in Xcode developer productivity, especially when working with modern AI assistants.

Setup Guide

XCF helps you get started quickly with a simple installation process.

Installation

# Clone the repository
git clone https://github.com/codefreezeai/xcf.git
cd xcf

# Build the project
swift build -c release

# Create a symbolic link for easy access
ln -s "$(pwd)/.build/release/xcf" /usr/local/bin/xcf

Permissions

Grant XCF the permissions needed to automate Xcode:

# Grant Xcode automation permissions
xcf grant

Configuration

Configure XCF as an MCP server by editing your configuration file:

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

Environment Variables

Add XCF to your claude_desktop_config.json file with extra environment variables:

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

Project Selection

XCF allows you to select specific Xcode projects through simple commands:

# List all available Xcode projects
xcf list

# Set the active project
xcf open #

# Run the active project
xcf run

Security

XCF is designed with security in mind:

Workspace Protection - Safely works with projects in your designated workspace
Boundary Enforcement - Automatically prevents access outside workspace boundaries

XCF Source Code

The complete source code for XCF is available on GitHub. Built with 100% Swift for perfect integration with the Apple ecosystem.

View on GitHub

XCF Command Reference

Explore the powerful commands available in XCF to enhance your Xcode development workflow

Core Commands

use xcf - Activate XCF mode to connect AI assistants to Xcode
grant - Grant necessary permissions for Xcode automation
show - List all available Xcode projects and workspaces
open # - Select a specific Xcode project by number

Project Commands

xcf build - Build the currently selected Xcode project
run - Execute the currently selected Xcode project
current - Display information about the currently selected project
env - Show all environment variables for the current context

Workflow Examples

Basic Development Workflow

use xcf - Activate the XCF tool
show - See all available Xcode projects
open # - Select a specific project by number
build - Build the selected project
run - Run the project in the simulator

Code Exploration

current - Check which project is currently selected
snippet tool to examine code
build - Test your changes

Additional Tools

snippet - Extract code snippets from files in the current project
list - Show all available tools in the XCF server
help - Display help information about XCF actions and usage
analyze - Full Swift code file analysis is coming soon

Note: You can access these commands after activating XCF with use xcf. After activation, you can use short commands like build instead of xcf build.

Code Snippets

XCF helps your AI assistant understand and fix code with powerful snippet extraction.

For AI Function Calls

# To get an entire file:
mcp_xcf_snippet(filePath="/full/path/to/file.swift", entireFile=true)

# For specific line ranges:
mcp_xcf_snippet(filePath="/full/path/to/file.swift", startLine=10, endLine=20)

For Human Commands

XCF now supports simplified, user-friendly snippet commands:

# To get an entire file, just use the filename:
snippet filename.swift

# For specific line ranges (still available but typically not needed):
snippet /full/path/to/file.swift 10 20

Smart Path Resolution

When a file isn't found at the exact path, XCF will intelligently search for it in:

The current working directory
The workspace folder specified in the environment
Subdirectories (one level deep) in the workspace
The current project directory

This means you can usually just use the filename without any path:

snippet Constants.swift

The simplified syntax makes code exploration much faster and more intuitive during conversations with your AI assistant.

Accelerate Xcode Development with AI