XCF Xcode MCP Server

Un servidor MCP basado en Swift que se integra con Xcode para mejorar los flujos de trabajo de desarrollo con IA.

Documentación

🚀 Servidor MCP XCF Xcode

¡La forma Swift de potenciar tu flujo de trabajo con IA!

🖌️ Novedades en la versión 1.0.6

Un servidor MCP más ágil centrado en la automatización de proyectos Xcode, lectura de archivos, navegación de directorios, análisis de Swift y fragmentos de código.
Se eliminaron las herramientas de diff, edición de código y documentos de Xcode del servidor MCP, junto con la dependencia MultiLineDiff (D1F).
Paquetes descargables en DMG y ZIP, con un acceso directo a Aplicaciones en el DMG para una instalación por arrastrar y soltar.
Aplicación macOS universal para Apple silicon e Intel, dirigida a macOS 13.5 o posterior.
Correcciones de compatibilidad para compilaciones empaquetadas: xcf-swift fijado en 1.0.0 y puntos de llamada MCP adaptados al SDK actualizado.

Actualización: usa las herramientas de edición nativas de tu cliente para las operaciones eliminadas de XCF. Reemplaza la aplicación y reinicia tu cliente MCP para recargar la lista de herramientas.

Notas de la versión · Cambios desde la 1.0.5

Acelera la creación de aplicaciones Xcode con xcf, un servidor MCP basado en Swift, extremadamente simple, diseñado para Cursor, Claude Code y VSCode: ¡sin TypeScript, sin JavaScript, sin complicaciones!

🧰 Instalación y configuración de XCF

Descargas

Paquete	Instalación
XCF 1.0.6 — DMG para macOS	Recomendado: abre la imagen y arrastra xcf.app al acceso directo de Aplicaciones.
XCF 1.0.6 — ZIP para macOS	Extrae el archivo y mueve xcf.app a /Applications.

El objetivo de implementación mínimo de la aplicación empaquetada es macOS 13.5, verificado en ejecutables arm64 y x86_64. No se han realizado pruebas de ejecución en macOS 13.5.

Pasos de instalación

Instala XCF usando cualquiera de las descargas anteriores.
Inicia la aplicación para aprobar la descarga de internet.

Verás la siguiente alerta (esto es normal):

Haz clic en el botón "Press to Quit this XCF Xcode MCP Server".

💡 Solución de problemas: Si XCF no muestra la alerta, ejecuta este comando:
codesign --force --deep --sign - /Applications/xcf.app

También puedes compilar xcf desde el código fuente usando Xcode.

Nota sobre el archivo fuente: los paquetes de la aplicación 1.0.6 adjuntos incluyen correcciones de compatibilidad realizadas después de la etiqueta 1.0.6. Los archivos fuente generados automáticamente por GitHub para esa etiqueta no incluyen esas correcciones.

🔧 Configuración rápida

Requisitos mínimos:

macOS 13.5 o posterior para la aplicación empaquetada.
Xcode para la automatización de proyectos Xcode.
Un cliente MCP configurado para iniciar XCF a través de la entrada/salida estándar.

Añade xcf a tu archivo de configuración MCP:

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

Ubicaciones de configuración

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

⚠️ Importante: Reinicia tu asistente de IA después de la configuración o actualiza la herramienta.

⚙️ Configuración avanzada

Para clientes que no sean Cursor o usuarios que requieran un control estricto a nivel de proyecto:

{
  "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"
      }
    }
  }
}

Estas variables de entorno te permiten:

Preseleccionar un proyecto Xcode específico con el que trabajar
Definir un límite de espacio de trabajo personalizado por seguridad

✨ Características clave

Cero dependencias: Fácil de instalar, sin depender de otros servidores MCP
Detección automática de proyectos: Selecciona automáticamente tu proyecto Xcode para que puedas empezar a codificar de inmediato
Manejo de errores en tiempo real: xcf build o xcf run envía errores y advertencias de Xcode directamente a tu IDE de IA
Correcciones impulsadas por IA: Deja que Claude corrija errores y fallos durante tus sesiones de codificación
Comandos intuitivos: Estructura de comandos simple y amigable para desarrolladores para máxima productividad
Operaciones integrales de archivos: Lee archivos y directorios con facilidad
Integración con Xcode: Compila, ejecuta y gestiona proyectos Xcode directamente
Análisis avanzado de código: Obtén análisis detallado de código Swift sin compilar en Xcode

🛠️ Perfecto para desarrolladores Swift

La herramienta está diseñada por desarrolladores Swift, para desarrolladores Swift. Comandos como build, run, show y nuestras nuevas operaciones de archivos y directorios hacen que el flujo de trabajo sea intuitivo y natural.

📋 Referencia de comandos

Comando xcf	Descripción de la acción
`show`	Lista los proyectos Xcode abiertos
`open #`	Selecciona un proyecto por número
`run`	Ejecuta el proyecto actual
`build`	Compila el proyecto actual
`current`	Muestra el proyecto seleccionado
`env`	Muestra las variables de entorno
`pwd`	Muestra la carpeta actual (alias: dir, path)
`help`	Muestra todos los comandos disponibles

Operaciones de archivos

Comando	Descripción
`read_file <file>`	Lee el contenido de un archivo
`read_dir [path] [extension]`	Lista el contenido de un directorio
`cd_dir <path>`	Cambia de directorio

Herramientas de análisis

Comando	Descripción
`snippet <file> [start] [end]`	Extrae fragmentos de código
`analyzer <file> [start] [end]`	Analiza código Swift
`lz <file>`	Abreviatura para el analizador

📄 Uso de fragmentos de código

Para comandos humanos

xcf admite comandos de fragmentos simplificados y fáciles de usar:

Para obtener un archivo completo, solo usa el nombre del archivo:

xcf snippet filename.swift

En muchos casos no necesitas rutas completas: xcf encontrará y mostrará inteligentemente el contenido completo del archivo.

Para rangos de líneas específicos:

xcf snippet filename.swift 10 20

Puedes usar cualquiera de los dos formatos para operaciones de archivos:

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)

Para rangos de líneas específicos:

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

Para asistentes de IA

Cuando uses xcf a través de herramientas MCP, usa esta sintaxis:

mcp_xcf_snippet filePath="filename.swift" entireFile=true

Para rangos de líneas específicos:

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

Resolución inteligente de rutas

Cuando un archivo no se encuentra en la ruta exacta, xcf lo buscará inteligentemente en:

Primero intenta con la ruta exacta proporcionada
Resuelve rutas relativas usando el directorio de trabajo actual
Busca en el directorio del proyecto actual y un nivel arriba
Busca en la carpeta del espacio de trabajo definida por WORKSPACE_FOLDER_PATHS
Busca recursivamente en las carpetas del espacio de trabajo con profundidad limitada
Como último recurso, realiza una búsqueda difusa de nombres de archivo similares

Esta resolución inteligente de rutas se usa de manera consistente en TODAS las operaciones de archivos en xcf, incluyendo:

Lectura de archivos y fragmentos de código
Análisis de código
Operaciones de directorio

Esto significa que normalmente puedes usar solo el nombre del archivo sin ninguna ruta para cualquier operación:

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

O para asistentes de IA:

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

🔍 Análisis de código Swift

Para comandos humanos

Analiza un archivo Swift completo en busca de problemas potenciales:

xcf analyze filename.swift

O usa la versión abreviada:

xcf lz filename.swift

Para rangos de líneas específicos:

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

Para asistentes de IA

Cuando uses xcf a través de herramientas MCP, usa esta sintaxis:

mcp_xcf_analyzer filePath="filename.swift" entireFile=true

O usa la versión abreviada:

mcp_xcf_xcf action="lz filename.swift"

Para rangos de líneas específicos:

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

El análisis identifica problemas como:

Problemas de estilo y formato de código
Funciones con alta complejidad
Variables y símbolos no utilizados
Números mágicos
Métodos largos
Y más

🧩 Herramientas MCP (21 herramientas)

Herramientas principales

Herramienta	Descripción
`xcf`	Ejecuta acciones de xcf (show, open, build, run, current, env, pwd, analyze, lz)
`list`	Lista todas las herramientas disponibles en este servidor
`xcf_help`	Ayuda rápida solo para acciones de xcf
`help`	Ayuda completa con ejemplos comunes
`use_xcf`	Activa el modo XCF
`tools`	Muestra referencia detallada de todas las herramientas, incluidas las llamadas de funciones de IA
`show_help`	Muestra información de ayuda sobre los comandos disponibles

Herramientas de gestión de proyectos

Herramienta	Descripción
`build_project`	Compila el proyecto Xcode actual
`run_project`	Ejecuta el proyecto Xcode actual
`list_projects`	Lista todos los proyectos Xcode abiertos
`select_project`	Selecciona un proyecto Xcode por número
`show_current_project`	Muestra información sobre el proyecto seleccionado actualmente
`show_env`	Muestra todas las variables de entorno
`show_folder`	Muestra la carpeta de trabajo actual
`grant_permission`	Otorga permisos de automatización de Xcode

Herramientas del sistema de archivos

Herramienta	Descripción
`read_file`	Lee el contenido de un archivo
`read_dir`	Lista el contenido de un directorio
`cd_dir`	Cambia el directorio actual

Herramientas de análisis de código

Herramienta	Descripción
`snippet`	Extrae fragmentos de código de archivos
`analyzer`	Analiza código Swift en busca de problemas potenciales
`analyze_swift_code`	Analiza código Swift con grupos de verificación personalizables (syntax, style, safety, performance, bestPractices)

Para llamadas de funciones de IA

Para obtener un archivo completo:

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

Para rangos de líneas específicos:

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

Para analizar un archivo completo:

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

Para rangos de líneas específicos:

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

Trabajar con archivos y directorios

Lee un archivo:

mcp_xcf_read_file filePath="main.swift"

Lista el contenido de un directorio:

mcp_xcf_read_dir directoryPath="."

Lista solo archivos Swift:

mcp_xcf_read_dir directoryPath="src" fileExtension="swift"

Cambia de directorio:

mcp_xcf_cd_dir directoryPath="src"

🔒 Características de seguridad

Trabaja de forma segura con proyectos en tu espacio de trabajo designado
Evita automáticamente el acceso fuera de los límites de tu espacio de trabajo
Redirige a alternativas seguras cuando es necesario
Usa variables de entorno para definir límites seguros

🔄 Ejemplos de flujo de trabajo

Flujo de trabajo básico (para humanos)

xcf show - Ver proyectos disponibles
xcf open 1 - Seleccionar un proyecto
xcf build - Compilar el proyecto
xcf run - Ejecutar el proyecto

Flujo de trabajo de análisis de código (para humanos)

xcf current - Verificar el proyecto actual
xcf snippet filename.swift - Examinar el código
xcf lz filename.swift - Analizar el código
xcf build - Compilar después de corregir problemas

Flujo de trabajo de manipulación de archivos (para humanos)

read_dir . - Listar archivos en el directorio actual
read_file main.swift - Ver el contenido de un archivo
Usar herramientas nativas del agente para editar archivos
xcf build - Compilar después de los cambios

Flujo de trabajo básico (para asistentes de IA)

mcp_xcf_xcf action="show" - Ver proyectos disponibles
mcp_xcf_xcf action="open 1" - Seleccionar un proyecto
mcp_xcf_xcf action="build" - Compilar el proyecto
mcp_xcf_xcf action="run" - Ejecutar el proyecto

Flujo de trabajo de análisis de código (para asistentes de IA)

mcp_xcf_xcf action="current" - Verificar el proyecto actual
mcp_xcf_snippet filePath="filename.swift" entireFile=true - Examinar el código
mcp_xcf_analyzer filePath="filename.swift" entireFile=true - Analizar el código
mcp_xcf_xcf action="build" - Compilar después de corregir problemas

Flujo de trabajo de manipulación de archivos (para asistentes de IA)

mcp_xcf_read_dir directoryPath="." - Listar archivos en el directorio actual
mcp_xcf_read_file filePath="main.swift" - Ver el contenido de un archivo
Usar la herramienta nativa edit_file del agente para editar archivos
mcp_xcf_xcf action="build" - Compilar después de los cambios

📺 Demo

Mira XCF en acción: Demo en YouTube

❓ Solución de problemas

Si los comandos fallan, verifica:

Que la instalación de xcf sea correcta
Actualizar el servidor MCP de xcf
Verifica que el servidor se inicie y esté en tu carpeta /Applications
Variables de entorno con env como "server"
Reinicia tu asistente de IA

🤝 Comunidad de código abierto

¡Los ingenieros de Swift son bienvenidos a contribuir! Ayúdanos a hacer xcf aún mejor.

💯 100% Swift. 100% Código abierto.

Repositorio de GitHub

Creado por XCodeFreeze Automation y CodeFreeze.ai: ¡llevando el futuro del desarrollo Swift a tu alcance!

AgentiLoop: agentiloop.ai