XcodeBuild MCP

Un servidor que proporciona herramientas para la gestión de proyectos de Xcode, gestión de simuladores y utilidades de aplicaciones.

GitHub
6.4k
Prueba este MCPPatrocinado

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 paquete único 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 del 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 usa 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.