Servidor MCP de Xcode

Name: Xcode MCP Server
Author: PolarVista

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

Iniciar el servidor:
npm run start /path/to/build/logs/directory
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