XcodeBuildMCP

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

Instalación

XcodeBuildMCP 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 por IA. Cualquiera de los métodos de instalación le 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

Verifique cualquiera de las instalaciones:

xcodebuildmcp --help

Conecte su cliente MCP

Los fragmentos de configuración para Cursor, Claude Code y Codex se pueden encontrar 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 xcodebuildmcp@latest mcp sin necesidad de una instalación global.

Related MCP server: MCP Xcode Server

Requisitos

• macOS 14.5 o posterior

• Xcode 16.x o posterior

• Node.js 18.x o posterior (no requerido para la instalación con Homebrew)

Habilidades

XcodeBuildMCP ahora incluye dos habilidades de agente opcionales:

• Habilidad MCP: Prepara al agente con instrucciones sobre cómo utilizar 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 instale directamente mediante npx sin una instalación global:

npx -y xcodebuildmcp@latest init

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

Notas

• XcodeBuildMCP solicita a xcodebuild que omita la validación de macros para evitar errores al compilar proyectos que utilizan Swift Macros.

• Las herramientas de dispositivo requieren que la firma de código esté configurada en Xcode. Consulte Firma de código de dispositivo.

Privacidad

XcodeBuildMCP utiliza Sentry únicamente para la telemetría de errores de tiempo de ejecución internos. Para obtener detalles e instrucciones de exclusión, consulte 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

Compruebe si hay actualizaciones y actualice 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. Consulte la guía de CLI para obtener 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 la 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

• Contribución: https://xcodebuildmcp.com/docs/contributing

Licencia

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