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

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