XcodeBuildMCP

Un servidor y CLI del Protocolo de Contexto de Modelo (MCP) que proporciona herramientas para uso de agentes al trabajar en proyectos de iOS y macOS.

GitHub

6.2k

¿Qué puedes hacer con Xcode Build MCP?

Construye una aplicación para el simulador — pídele al agente que ejecute simulator build con un esquema y una ruta de proyecto para compilar tu proyecto de iOS o macOS.
Ejecuta pruebas en un simulador específico — usa simulator test con una ruta de productos de prueba y el nombre del simulador para ejecutar paquetes de prueba previamente preparados.
Prepara productos de prueba sin ejecutarlos — invoca simulator build con --build-for-testing y una --test-products-path para generar paquetes portátiles .xctestproducts.
Inicia el servidor MCP para un cliente de IA — ejecuta el subcomando mcp para que tu agente de codificación pueda acceder a todas las herramientas de compilación y prueba a través del protocolo MCP.
Lista las herramientas disponibles desde la CLI — usa el comando tools para descubrir qué operaciones están disponibles en el entorno actual.
Verifica y aplica actualizaciones — ejecuta upgrade --check o upgrade --yes para actualizar la CLI en el lugar.

Documentación

Un servidor y CLI del Protocolo de Contexto de Modelo (MCP) que proporciona herramientas para uso de agentes al trabajar en proyectos de iOS y macOS.

Instalación

XcodeBuildMCP se distribuye como un único paquete con dos modos: una CLI para uso directo en terminal y un servidor MCP para agentes de codificación con IA. Cualquier método de instalación te proporciona ambos.

Opción A — Homebrew

brew tap getsentry/xcodebuildmcp
brew install xcodebuildmcp

Opción B — npm (Node.js 18+)

npm install -g xcodebuildmcp@latest

Verifica cualquiera de las instalaciones:

xcodebuildmcp --help

Conecta tu cliente MCP

Fragmentos de configuración listos para usar para Cursor, Claude Code, Codex, se pueden encontrar en la página de documentación oficial Clientes MCP. La mayoría de los clientes también pueden ejecutar el servidor MCP bajo demanda mediante npx -y xcodebuildmcp@latest mcp sin una instalación global.

Requisitos

macOS 14.5 o posterior
Xcode 16.x o posterior
Node.js 18.x o posterior (no es necesario para la instalación con Homebrew)

Habilidades

XcodeBuildMCP ahora incluye dos habilidades opcionales para agentes:

Habilidad MCP: Prepara al agente con instrucciones sobre cómo usar las herramientas del servidor MCP (opcional al usar el servidor MCP).
Habilidad CLI: Prepara al agente con instrucciones sobre cómo navegar por la CLI (recomendado al usar la CLI).

Para instalar con un binario global:

xcodebuildmcp init

O instalar directamente mediante npx sin una instalación global:

npx -y xcodebuildmcp@latest init

Para más información sobre la instalación de habilidades, consulta Habilidades del Agente.

Notas

XcodeBuildMCP solicita a xcodebuild que omita la validación de macros para evitar errores al compilar proyectos que usan Swift Macros.
Las herramientas de dispositivo requieren que la firma de código esté configurada en Xcode. Consulta Firma de Código para Dispositivos.

Privacidad

XcodeBuildMCP utiliza Sentry únicamente para telemetría de errores internos en tiempo de ejecución. Para detalles e instrucciones de exclusión, consulta Privacidad y Telemetría.

CLI

XcodeBuildMCP proporciona una interfaz de línea de comandos unificada. El subcomando mcp inicia el servidor MCP, mientras que todos los demás comandos proporcionan acceso directo a las herramientas desde la terminal:

# Install globally
npm install -g xcodebuildmcp@latest

# Start the MCP server (for MCP clients)
xcodebuildmcp mcp

# List available tools
xcodebuildmcp tools

# Build for simulator
xcodebuildmcp simulator build --scheme MyApp --project-path ./MyApp.xcodeproj

# Prepare portable test products without running tests
xcodebuildmcp simulator build --scheme MyApp --project-path ./MyApp.xcodeproj --simulator-name "iPhone 17" --build-for-testing --test-products-path ./MyApp.xctestproducts

# Run previously prepared test products
xcodebuildmcp simulator test --test-products-path ./MyApp.xctestproducts --simulator-name "iPhone 17"

Busca actualizaciones y actualiza en el lugar:

xcodebuildmcp upgrade --check
xcodebuildmcp upgrade --yes

La CLI utiliza un demonio por espacio de trabajo para operaciones con estado (captura de registros, depuración, etc.) que se inicia automáticamente cuando es necesario. Consulta la guía de CLI para la documentación completa.

Documentación

Instalación: https://xcodebuildmcp.com/docs/installation
Configuración: https://xcodebuildmcp.com/docs/setup
Clientes MCP: https://xcodebuildmcp.com/docs/clients
Uso de CLI: https://xcodebuildmcp.com/docs/cli
Configuración y opciones: https://xcodebuildmcp.com/docs/configuration
Referencia de herramientas: https://xcodebuildmcp.com/docs/tools
Solución de problemas: https://xcodebuildmcp.com/docs/troubleshooting
Privacidad: https://xcodebuildmcp.com/docs/privacy
Habilidades: https://xcodebuildmcp.com/docs/skills
Contribuciones: https://xcodebuildmcp.com/docs/contributing

Licencia

Este proyecto está licenciado bajo la Licencia MIT - consulta el archivo LICENSE para más detalles. Para avisos de licencias de terceros, consulta el archivo THIRD_PARTY_LICENSES para más detalles. Para atribuciones de paquetes npm, consulta el archivo THIRD_PARTY_PACKAGE_LICENSES para más detalles.