local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

Facilitates iOS app development by providing build and test capabilities for iOS simulator targets, with default configuration for iPhone 15 Pro simulator.
Enables building and testing Xcode projects with the ability to specify schemes, configurations, and destinations. Supports running specific tests, generating code coverage reports, and accessing build and test logs.

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

# 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

This server cannot be installed

-

security - not tested

F

license - not found

-

quality - not tested

Un servidor de protocolo de contexto de modelo que permite a los asistentes de IA construir y probar proyectos Xcode directamente a través de una interfaz estandarizada, con capacidades para ejecutar pruebas, monitorear el progreso y acceder a registros en tiempo real.

Related Resources

Reddit Discussion about this server

Xcode MCP Server