Permite que un agente de IA construya, pruebe y gestione proyectos de Xcode para iOS y macOS mediante herramientas MCP o una CLI.
También conocido como getsentry/MobileBuildMCP
- Stars
- 6573
- Herramientas
- 24
- Descargas, 30 días
- —
- Última versión
- —
- Último commit
- 13 nov 2026
- Licencia
- MIT
¿Qué es MobileBuildMCP MCP?
Permite que un agente de IA construya, pruebe y gestione proyectos de Xcode para iOS y macOS mediante herramientas MCP o una CLI. Expone 24 herramientas, como session_show_defaults, session_use_defaults_profile, session_set_defaults.
Resumen generado a partir del README del proyecto
Acerca del MCP server de MobileBuildMCP
MobileBuildMCP permite gestionar flujos de trabajo de desarrollo de iOS y macOS a través de un agente de IA. Proporciona un puente entre los asistentes de codificación con IA y Xcode, permitiendo que los agentes construyan, prueben y gestionen proyectos directamente. Los desarrolladores pueden usarlo como un MCP server dedicado para clientes como Claude Code o Cursor, o interactuar con él mediante una interfaz de línea de comandos unificada.
La instalación está disponible vía Homebrew o npm, y el sistema requiere macOS 14.5 o posterior junto con Xcode 16.x. La herramienta incluye lógica específica para omitir la validación de macros durante los builds para asegurar que los proyectos que usan Swift Macros no encuentren errores. Para quienes usan la CLI, un daemon por espacio de trabajo gestiona tareas con estado como la captura de logs y la depuración. Aunque el server está diseñado para uso agéntico, también funciona como una herramienta de terminal estándar para la gestión manual de proyectos.
Qué puedes hacer con él
- 1Construir proyectos para simuladoresPide a un agente de IA que compile un scheme de Xcode específico para un target de simulador.
- 2Preparar productos de pruebaIndica al agente que genere productos de prueba portátiles sin ejecutar las pruebas inmediatamente.
- 3Ejecutar pruebas automatizadasHaz que la IA ejecute productos de prueba preparados previamente en un nombre de simulador específico.
- 4Gestionar actualizaciones de softwareUsa la CLI para buscar y aplicar actualizaciones de versión de la herramienta.
Escrito a partir del README del proyecto. Cada caso de uso se verifica con una cita del mismo.
Cómo instalar MobileBuildMCP MCP
Formatos verificados el 10 nov 2026Añadir a CursorAñadir a GooseInstalar MobileBuildMCP MCP en Claude Code
$ claude mcp add mobilebuildmcp -- npx -y mobilebuildmcp mcpInstalar MobileBuildMCP MCP en Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"mobilebuildmcp": {
"command": "npx",
"args": [
"-y",
"mobilebuildmcp",
"mcp"
]
}
}
}Instalar MobileBuildMCP MCP en VS Code
.vscode/mcp.json
{
"servers": {
"mobilebuildmcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"mobilebuildmcp",
"mcp"
]
}
}
}Instalar MobileBuildMCP MCP en VS Code CLI
$ code --add-mcp '{"name":"mobilebuildmcp","type":"stdio","command":"npx","args":["-y","mobilebuildmcp","mcp"]}'Instalar MobileBuildMCP MCP en Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"mobilebuildmcp": {
"command": "npx",
"args": [
"-y",
"mobilebuildmcp",
"mcp"
]
}
}
}Instalar MobileBuildMCP MCP en Codex
$ codex mcp add mobilebuildmcp -- npx -y mobilebuildmcp mcpInstalar MobileBuildMCP MCP en Codex config.toml
~/.codex/config.toml
[mcp_servers.mobilebuildmcp] command = "npx" args = ["-y", "mobilebuildmcp", "mcp"]
Instalar MobileBuildMCP MCP en Gemini CLI
$ gemini mcp add -s user mobilebuildmcp npx -- -y mobilebuildmcp mcpInstalar MobileBuildMCP MCP en Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"mobilebuildmcp": {
"command": "npx",
"args": [
"-y",
"mobilebuildmcp",
"mcp"
]
}
}
}Iniciado por HostedMCP el 16 nov 2026
Ejecutamos este comando para mobilebuildmcp 2.7.1 en un contenedor aislado sin red ni claves. Respondió y listó 24 herramientas.
Herramientas de MobileBuildMCP MCP 24
Leído del servidor con tools/listsession_show_defaultsSolo lecturaShow current active defaults. Required before your first build/run/test call in a session — do not assume defaults are configured.
session_use_defaults_profileAcciónSwitch the active session defaults profile.
session_set_defaultsAcciónSet session defaults for the active profile, or for a specified profile and make it active.
session_clear_defaultsAcciónClear session defaults for the active profile or a specified profile.
list_simsSolo lecturaList iOS simulators.
boot_simAcciónBoot iOS simulator for manual/non-build flows. Not required before simulator build-and-run (build_run_sim).
open_simSolo lecturaOpen the simulator frontend for visibility and manual workflows. Not required before simulator build-and-run (build_run_sim).
build_simAcciónBuild for iOS sim (compile-only, no launch).
build_run_simAcciónBuild, install, and launch on iOS Simulator, booting it when needed. Runtime logs are captured automatically and the log file path is included in the response. Preferred single-step run tool when defaults are set.
test_simAcciónTest on iOS sim.
get_sim_app_pathSolo lecturaGet sim built app path.
install_app_simAcciónInstall app on sim.
| session_show_defaults | Show current active defaults. Required before your first build/run/test call in a session — do not assume defaults are configured. | Solo lectura |
| session_use_defaults_profile | Switch the active session defaults profile. | Acción |
| session_set_defaults | Set session defaults for the active profile, or for a specified profile and make it active. | Acción |
| session_clear_defaults | Clear session defaults for the active profile or a specified profile. | Acción |
| list_sims | List iOS simulators. | Solo lectura |
| boot_sim | Boot iOS simulator for manual/non-build flows. Not required before simulator build-and-run (build_run_sim). | Acción |
| open_sim | Open the simulator frontend for visibility and manual workflows. Not required before simulator build-and-run (build_run_sim). | Solo lectura |
| build_sim | Build for iOS sim (compile-only, no launch). | Acción |
| build_run_sim | Build, install, and launch on iOS Simulator, booting it when needed. Runtime logs are captured automatically and the log file path is included in the response. Preferred single-step run tool when defaults are set. | Acción |
| test_sim | Test on iOS sim. | Acción |
| get_sim_app_path | Get sim built app path. | Solo lectura |
| install_app_sim | Install app on sim. | Acción |
Mostrar las 24 herramientasMostrar menos herramientas
launch_app_simAcciónLaunch app on simulator. Runtime logs are captured automatically and the log file path is included in the response.
stop_app_simAcciónStop sim app.
record_sim_videoAcciónRecord sim video.
cleanAcciónClean build products.
discover_projsSolo lecturaScans a directory (defaults to workspace root) to find Xcode project (.xcodeproj) and workspace (.xcworkspace) files. Use when project/workspace path is unknown.
list_schemesSolo lecturaList Xcode schemes.
show_build_settingsSolo lecturaShow build settings.
get_app_bundle_idSolo lecturaExtract bundle id from .app.
screenshotSolo lecturaCapture screenshot.
snapshot_uiSolo lecturaCapture a semantic rs/1 runtime UI snapshot with elementRef targets. Observe once, use tap for one target or batch for multiple same-screen targets, and refresh after navigation, scrolling, sheet changes, or obvious layout changes.
get_coverage_reportSolo lecturaShow per-target code coverage from an xcresult bundle.
get_file_coverageSolo lecturaShow function-level coverage and uncovered line ranges for a specific file.
| launch_app_sim | Launch app on simulator. Runtime logs are captured automatically and the log file path is included in the response. | Acción |
| stop_app_sim | Stop sim app. | Acción |
| record_sim_video | Record sim video. | Acción |
| clean | Clean build products. | Acción |
| discover_projs | Scans a directory (defaults to workspace root) to find Xcode project (.xcodeproj) and workspace (.xcworkspace) files. Use when project/workspace path is unknown. | Solo lectura |
| list_schemes | List Xcode schemes. | Solo lectura |
| show_build_settings | Show build settings. | Solo lectura |
| get_app_bundle_id | Extract bundle id from .app. | Solo lectura |
| screenshot | Capture screenshot. | Solo lectura |
| snapshot_ui | Capture a semantic rs/1 runtime UI snapshot with elementRef targets. Observe once, use tap for one target or batch for multiple same-screen targets, and refresh after navigation, scrolling, sheet changes, or obvious layout changes. | Solo lectura |
| get_coverage_report | Show per-target code coverage from an xcresult bundle. | Solo lectura |
| get_file_coverage | Show function-level coverage and uncovered line ranges for a specific file. | Solo lectura |
Verificaciones automáticas
Ejecutado 16 nov 2026Informe completo →Pasó nuestras verificaciones automáticas. Esto no es una auditoría de seguridad: lee el código y dale al servidor el acceso más limitado que necesite. Cómo funcionan las verificaciones
- Repositorio de origen vinculado y accesiblegetsentry/mobilebuildmcp is public and reachablegithub.com/getsentry/mobilebuildmcp ↗Aprobado
- El paquete indica este repositorio como su origenmobilebuildmcp names getsentry/mobilebuildmcp as sourcenpmjs.com/package/mobilebuildmcp ↗Aprobado
- Procedencia de la compilación (atestación de Sigstore)Sigstore attestation for mobilebuildmcpnpmjs.com/package/mobilebuildmcp/v/2.7.1#provenance ↗Aprobado
- Licencia de código abierto (OSI)MITspdx.org/licenses/MIT.html ↗Aprobado
- Commit o lanzamiento en el último añoLast commit or release 2026-11-13github.com/getsentry/mobilebuildmcp ↗Aprobado
- OpenSSF ScorecardNo verificado
- El nombre del paquete no es similar a un paquete popularNo popular package one edit away from mobilebuildmcpAprobado
- No hay avisos críticos en el paquete ni en sus dependenciasNo verificado
- Sin instrucciones ocultas para el modelo24 tool descriptions and the README read; no override phrases, credential paths or hidden charactersAprobado
- Las herramientas destructivas están etiquetadasNo tool named like delete, drop or execAprobado
- El endpoint remoto responde al handshake de MCPNo verificado
README
Ver en GitHubA Model Context Protocol (MCP) server and CLI that provides tools for agent use when working on iOS and macOS projects.
Installation
MobileBuildMCP ships as a single package with two modes: a CLI for direct terminal use and an MCP server for AI coding agents. Either install method gives you both.
Option A — Homebrew
brew tap getsentry/xcodebuildmcp
brew install mobilebuildmcp
Option B — npm (Node.js 18+)
npm install -g mobilebuildmcp@latest
Verify either install:
mobilebuildmcp --help
Connect your MCP client
Drop-in config snippets for Cursor, Claude Code, Codex, can be found in the official docs page MCP Clients. Most clients can also run the MCP server on demand via npx -y mobilebuildmcp@latest mcp without a global install.
Requirements
- macOS 14.5 or later
- Xcode 16.x or later
- Node.js 18.x or later (not required for Homebrew installation)
Skills
MobileBuildMCP now includes two optional agent skills:
-
MCP Skill: Primes the agent with instructions on how to use the MCP server's tools (optional when using the MCP server).
-
CLI Skill: Primes the agent with instructions on how to navigate the CLI (recommended when using the CLI).
To install with a global binary:
mobilebuildmcp init
Or install directly via npx without a global install:
npx -y mobilebuildmcp@latest init
For further information on installing skills, see Agent Skills.
Notes
- MobileBuildMCP requests xcodebuild to skip macro validation to avoid errors when building projects that use Swift Macros.
- Device tools require code signing to be configured in Xcode. See Device Code Signing.
Privacy
MobileBuildMCP uses Sentry for internal runtime error telemetry only. For details and opt-out instructions, see Privacy & Telemetry.
CLI
MobileBuildMCP provides a unified command-line interface. The mcp subcommand starts the MCP server, while all other commands provide direct terminal access to tools:
# 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"
Check for updates and upgrade in place:
mobilebuildmcp upgrade --check
mobilebuildmcp upgrade --yes
The CLI uses a per-workspace daemon for stateful operations (log capture, debugging, etc.) that auto-starts when needed. See the CLI guide for full documentation.
Documentation
- Installation: https://github.com/getsentry/xcodebuildmcp.com/blob/main/app/docs/_content/installation.mdx
- Setup: https://github.com/getsentry/xcodebuildmcp.com/blob/main/app/docs/_content/setup.mdx
- MCP clients: https://github.com/getsentry/xcodebuildmcp.com/blob/main/app/docs/_content/clients.mdx
- CLI usage: https://github.com/getsentry/xcodebuildmcp.com/blob/main/app/docs/_content/cli.mdx
- Configuration and options: https://github.com/getsentry/xcodebuildmcp.com/blob/main/app/docs/_content/configuration.mdx
- Tools reference: https://github.com/getsentry/xcodebuildmcp.com/blob/main/app/docs/_content/tools.mdx
- Troubleshooting: https://github.com/getsentry/xcodebuildmcp.com/blob/main/app/docs/_content/troubleshooting.mdx
- Privacy: https://github.com/getsentry/xcodebuildmcp.com/blob/main/app/docs/_content/privacy.mdx
- Skills: https://github.com/getsentry/xcodebuildmcp.com/blob/main/app/docs/_content/skills.mdx
- Contributing: https://github.com/getsentry/xcodebuildmcp.com/blob/main/app/docs/_content/contributing.mdx
Licence
This project is licensed under the MIT License - see the LICENSE file for details. For third-party licensing notices see the THIRD_PARTY_LICENSES file for details. For npm package attributions see the THIRD_PARTY_PACKAGE_LICENSES file for details.
Preguntas sobre MobileBuildMCP MCP
¿Cómo agrego MobileBuildMCP MCP a Claude Code?
Ejecuta claude mcp add mobilebuildmcp -- npx -y mobilebuildmcp mcp en tu terminal. Añade --scope user para que esté disponible en todos los proyectos.
¿Cómo agrego MobileBuildMCP MCP a Cursor?
Abre ~/.cursor/mcp.json y añade el servidor en mcpServers, usando la configuración de Cursor que se muestra en la sección de instalación de arriba.
¿Qué herramientas proporciona MobileBuildMCP MCP?
Expone 24 herramientas, incluidas session_show_defaults, session_use_defaults_profile, session_set_defaults, session_clear_defaults, list_sims.
¿Qué hace MobileBuildMCP por los proyectos de iOS y macOS?
Proporciona herramientas MCP y comandos CLI que permiten a los agentes construir, probar y gestionar proyectos de Xcode para iOS y macOS, incluyendo builds para simuladores y productos de prueba.
¿Cómo instalo MobileBuildMCP?
Instálalo vía Homebrew con el tap de getsentry o vía npm de forma global con mobilebuildmcp@latest; ambos te proporcionan la CLI y el MCP server.
¿Cuáles son los requisitos del sistema para MobileBuildMCP?
Requiere macOS 14.5 o posterior y Xcode 16.x o posterior, además de Node.js 18.x o posterior, a menos que lo hayas instalado vía Homebrew.
¿Puedo realizar un build para un simulador desde la línea de comandos con MobileBuildMCP?
Sí, la CLI incluye un comando de build para simuladores que recibe un scheme y la ruta del proyecto.
¿MobileBuildMCP envía telemetría?
Utiliza Sentry únicamente para telemetría de errores internos en tiempo de ejecución, y la documentación explica cómo optar por no participar.