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

Related MCP server: Xcode MCP Server

Requisitos

• Node.js 16+

• Herramientas de línea de comandos de Xcode

• Mecanografiado

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

Instalación

# Clone the repository
git clone https://github.com/PolarVista/Xcode-mcp-server.git
cd xcode-mcp-server

# Install dependencies
npm install

# Build the server
npm run build

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:

build_project({
 projectPath: "/path/to/Project.xcodeproj",
 scheme: "MyApp",
 configuration: "Debug"
})

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:

run_tests({
 projectPath: "/path/to/Project.xcodeproj",
 scheme: "MyAppTests",
 testIdentifier: "LoginTests/testSuccessfulLogin",
 skipTests: ["PerformanceTests/testLargeDataLoad"],
 configuration: "Debug"
})

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

Maintenance

Resources

• NPM Package
• GitHub Repository
Need Help?
• Reddit Discussion
Related Servers

Tools

• analyze_fileB
• boot_simulatorC
• build_projectC
• compile_asset_catalogC
• get_active_projectB
• list_directoryC
• list_project_filesC
• list_simulatorsA