Servidor MCP de Xcode

El servidor MCP de Xcode proporciona una interfaz de protocolo de contexto de modelo para compilar y probar proyectos de Xcode. Permite a los asistentes de IA activar compilaciones, ejecutar pruebas, supervisar el progreso y acceder a los registros directamente a través de una interfaz estandarizada.

Características

• Cree proyectos de Xcode con esquemas y configuraciones personalizados

• Ejecutar pruebas unitarias con control granular (ejecutar pruebas específicas u omitir pruebas)

• Generar informes de cobertura de código

• Transmita registros de compilación y pruebas en tiempo real

• Acceda a informes detallados de compilación y pruebas

• Salida con formato JSON

• Persistencia automática del registro

Requisitos

• Node.js 16+

• Herramientas de línea de comandos de Xcode

• Mecanografiado

• Cliente compatible con MCP (por ejemplo, Claude Desktop)

Instalación

Uso con Claude Desktop

1. Iniciar el servidor:

   npm run start /path/to/build/logs/directory

2. En la configuración de Claude Desktop:

   "command": "node", "args": ["/path/to/the/xcode-mcp-server/build/index.js", "/path/to/your/project/folder"], "env": { "PATH": "/usr/bin:/bin:/usr/local/bin:/usr/sbin:/sbin" }

Herramientas disponibles

proyecto de construcción

Construye un proyecto Xcode con parámetros especificados.

Parámetros:

• projectPath (obligatorio): Ruta al .xcodeproj o .xcworkspace

• scheme (obligatorio): nombre del esquema de compilación

• configuration (opcional): Configuración de compilación (Depuración/Versión, predeterminada en Depuración)

• destination (opcional): Destino de compilación (predeterminado: "plataforma=iOS Simulator,nombre=iPhone 15 Pro")

Ejemplo de uso en Claude:

ejecutar_pruebas

Ejecuta pruebas unitarias con filtrado opcional.

Parámetros:

• projectPath (obligatorio): Ruta al .xcodeproj o .xcworkspace

• scheme (obligatorio): Nombre del esquema de prueba

• testIdentifier (opcional): prueba específica a ejecutar (por ejemplo, 'MyTests/testExample')

• skipTests (opcional): Matriz de identificadores de prueba para omitir

• configuration (opcional): Configuración de compilación (Depuración/Versión, predeterminada en Depuración)

• destination (opcional): Destino de prueba (predeterminado: "plataforma=iOS Simulator,nombre=iPhone 15 Pro")

Ejemplo de uso en Claude:

Registros

• Todos los registros se almacenan en el directorio base especificado en build-logs/

• Las operaciones de construcción crean:

  • Registro de texto sin formato ( build-[timestamp].log )

  • Registro con formato JSON ( build-[timestamp].log.json )

  • Informe de Xcode ( report-[timestamp].txt )

• Las operaciones de prueba crean:

  • Registro de pruebas ( test-[timestamp].log )

  • Registro con formato JSON ( test-[timestamp].log.json )

  • Informe de prueba ( test-report-[timestamp].txt )

  • Informe de cobertura de código ( coverage-[timestamp].txt )

• Se puede acceder al último registro (compilación o prueba) a través del recurso xcode-build://latest-log