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.5k

¿Qué puedes hacer con XcodeBuildMCP MCP?

  • Build for simulator — Pídele a tu IA que compile una app de iOS o macOS para un simulador específico usando un esquema nombrado y una ruta de proyecto.
  • Prepare test products — Haz que tu IA genere paquetes de prueba portátiles sin ejecutar pruebas, dirigidos a un simulador elegido.
  • Run prepared tests — Indica a tu IA que ejecute productos de prueba previamente compilados en un simulador especificado.
  • List available tools — Pide a tu IA que muestre el conjunto completo de comandos CLI y capacidades del servidor MCP que puede invocar.
  • Check for updates — Solicita a tu IA que verifique la versión instalada y actualice la herramienta en el lugar cuando sea necesario.

Documentación

Un servidor y CLI de Model Context Protocol (MCP) que proporciona herramientas para uso de agentes al trabajar en proyectos de iOS y macOS.

CI npm version License: MIT Node.js Xcode 16 macOS MCP Ask DeepWiki AgentAudit Security pkg.pr.new

Instalación

MobileBuildMCP 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 mobilebuildmcp

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

npm install -g mobilebuildmcp@latest

Verifica cualquiera de las instalaciones:

mobilebuildmcp --help

Conecta tu cliente MCP

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

Requisitos

  • macOS 14.5 o posterior
  • Xcode 16.x o posterior
  • Node.js 18.x o posterior (no requerido para la instalación mediante Homebrew)

Habilidades

MobileBuildMCP 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:

mobilebuildmcp init

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

npx -y mobilebuildmcp@latest init

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

Notas

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

Privacidad

MobileBuildMCP utiliza Sentry únicamente para telemetría interna de errores en tiempo de ejecución. Para más detalles e instrucciones de exclusión, consulta Privacidad y Telemetría.

CLI

MobileBuildMCP 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 mobilebuildmcp@latest

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

# List available tools
mobilebuildmcp tools

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

# Prepare portable test products without running tests
mobilebuildmcp 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
mobilebuildmcp simulator test --test-products-path ./MyApp.xctestproducts --simulator-name "iPhone 17"

Comprueba actualizaciones y actualiza en el lugar:

mobilebuildmcp upgrade --check
mobilebuildmcp 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

Licencia

Este proyecto está licenciado bajo la Licencia MIT; consulta el archivo LICENCIA para más detalles. Para avisos de licencias de terceros, consulta el archivo LICENCIAS_DE_TERCEROS. Para atribuciones de paquetes npm, consulta el archivo LICENCIAS_DE_PAQUETES_DE_TERCEROS.