Ermöglicht es einem AI Agent, iOS- und macOS-Xcode-Projekte über MCP Tools oder ein CLI zu erstellen, zu testen und zu verwalten.
Auch bekannt als getsentry/MobileBuildMCP
- Stars
- 6.573
- Tools
- 24
- Downloads, 30 Tage
- —
- Neueste Version
- —
- Letzter Commit
- 13. Nov. 2026
- Lizenz
- MIT
Was ist MobileBuildMCP MCP?
Ermöglicht es einem AI Agent, iOS- und macOS-Xcode-Projekte über MCP Tools oder ein CLI zu erstellen, zu testen und zu verwalten. Er stellt 24 Tools bereit, etwa session_show_defaults, session_use_defaults_profile, session_set_defaults.
Zusammenfassung generiert aus dem README des Projekts
Über MobileBuildMCP MCP server
MobileBuildMCP ermöglicht es dir, iOS- und macOS-Development-Workflows über einen AI Agent zu steuern. Es schlägt eine Brücke zwischen AI Coding Assistants und Xcode, sodass Agents Projekte direkt bauen, testen und verwalten können. Entwickler können es als dedizierten MCP server für Clients wie Claude Code oder Cursor nutzen oder über ein einheitliches CLI damit interagieren.
Die Installation ist via Homebrew oder npm möglich, und das System benötigt macOS 14.5 oder neuer sowie Xcode 16.x. Das Tool enthält spezifische Logik, um die Macro-Validierung während der Builds zu überspringen, damit Projekte, die Swift Macros nutzen, keine Fehler verursachen. Für Nutzer des CLI kümmert sich ein Workspace-spezifischer Daemon um zustandsbehaftete Aufgaben wie Log-Capture und Debugging. Während der Server für den agentischen Einsatz konzipiert ist, funktioniert er auch als Standard-Terminal-Tool für das manuelle Projektmanagement.
Was du damit machen kannst
- 1Projekte für Simulatoren bauenFordere einen AI Agent auf, ein spezifisches Xcode Scheme für ein Simulator-Target zu kompilieren.
- 2Test-Produkte vorbereitenAnweisung an den Agent, portable Test-Produkte zu generieren, ohne die Tests sofort auszuführen.
- 3Automatisierte Tests ausführenLasse die KI zuvor vorbereitete Test-Produkte auf einem spezifischen Simulator-Namen ausführen.
- 4Software-Updates verwaltenNutze das CLI, um nach Versions-Upgrades für das Tool zu suchen und diese anzuwenden.
Geschrieben aus dem README des Projekts. Jeder Use Case wurde gegen ein Zitat daraus geprüft.
So installierst du MobileBuildMCP MCP
Formate geprüft am 10. Nov. 2026Zu Cursor hinzufügenZu Goose hinzufügenMobileBuildMCP MCP in Claude Code installieren
$ claude mcp add mobilebuildmcp -- npx -y mobilebuildmcp mcpMobileBuildMCP MCP in Cursor installieren
~/.cursor/mcp.json
{
"mcpServers": {
"mobilebuildmcp": {
"command": "npx",
"args": [
"-y",
"mobilebuildmcp",
"mcp"
]
}
}
}MobileBuildMCP MCP in VS Code installieren
.vscode/mcp.json
{
"servers": {
"mobilebuildmcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"mobilebuildmcp",
"mcp"
]
}
}
}MobileBuildMCP MCP in VS Code CLI installieren
$ code --add-mcp '{"name":"mobilebuildmcp","type":"stdio","command":"npx","args":["-y","mobilebuildmcp","mcp"]}'MobileBuildMCP MCP in Claude Desktop installieren
claude_desktop_config.json
{
"mcpServers": {
"mobilebuildmcp": {
"command": "npx",
"args": [
"-y",
"mobilebuildmcp",
"mcp"
]
}
}
}MobileBuildMCP MCP in Codex installieren
$ codex mcp add mobilebuildmcp -- npx -y mobilebuildmcp mcpMobileBuildMCP MCP in Codex config.toml installieren
~/.codex/config.toml
[mcp_servers.mobilebuildmcp] command = "npx" args = ["-y", "mobilebuildmcp", "mcp"]
MobileBuildMCP MCP in Gemini CLI installieren
$ gemini mcp add -s user mobilebuildmcp npx -- -y mobilebuildmcp mcpMobileBuildMCP MCP in Gemini settings.json installieren
~/.gemini/settings.json
{
"mcpServers": {
"mobilebuildmcp": {
"command": "npx",
"args": [
"-y",
"mobilebuildmcp",
"mcp"
]
}
}
}Von HostedMCP gestartet am 16. Nov. 2026
Wir haben diesen Befehl für mobilebuildmcp 2.7.1 in einem isolierten Container ohne Netzwerk und ohne Schlüssel ausgeführt. Er hat geantwortet und 24 Tools gelistet.
MobileBuildMCP MCP tools 24
Vom Server mit tools/list gelesensession_show_defaultsNur lesendShow current active defaults. Required before your first build/run/test call in a session — do not assume defaults are configured.
session_use_defaults_profileAktionSwitch the active session defaults profile.
session_set_defaultsAktionSet session defaults for the active profile, or for a specified profile and make it active.
session_clear_defaultsAktionClear session defaults for the active profile or a specified profile.
list_simsNur lesendList iOS simulators.
boot_simAktionBoot iOS simulator for manual/non-build flows. Not required before simulator build-and-run (build_run_sim).
open_simNur lesendOpen the simulator frontend for visibility and manual workflows. Not required before simulator build-and-run (build_run_sim).
build_simAktionBuild for iOS sim (compile-only, no launch).
build_run_simAktionBuild, 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_simAktionTest on iOS sim.
get_sim_app_pathNur lesendGet sim built app path.
install_app_simAktionInstall 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. | Nur lesend |
| session_use_defaults_profile | Switch the active session defaults profile. | Aktion |
| session_set_defaults | Set session defaults for the active profile, or for a specified profile and make it active. | Aktion |
| session_clear_defaults | Clear session defaults for the active profile or a specified profile. | Aktion |
| list_sims | List iOS simulators. | Nur lesend |
| boot_sim | Boot iOS simulator for manual/non-build flows. Not required before simulator build-and-run (build_run_sim). | Aktion |
| open_sim | Open the simulator frontend for visibility and manual workflows. Not required before simulator build-and-run (build_run_sim). | Nur lesend |
| build_sim | Build for iOS sim (compile-only, no launch). | Aktion |
| 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. | Aktion |
| test_sim | Test on iOS sim. | Aktion |
| get_sim_app_path | Get sim built app path. | Nur lesend |
| install_app_sim | Install app on sim. | Aktion |
Alle 24 Tools anzeigenWeniger Tools anzeigen
launch_app_simAktionLaunch app on simulator. Runtime logs are captured automatically and the log file path is included in the response.
stop_app_simAktionStop sim app.
record_sim_videoAktionRecord sim video.
cleanAktionClean build products.
discover_projsNur lesendScans a directory (defaults to workspace root) to find Xcode project (.xcodeproj) and workspace (.xcworkspace) files. Use when project/workspace path is unknown.
list_schemesNur lesendList Xcode schemes.
show_build_settingsNur lesendShow build settings.
get_app_bundle_idNur lesendExtract bundle id from .app.
screenshotNur lesendCapture screenshot.
snapshot_uiNur lesendCapture 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_reportNur lesendShow per-target code coverage from an xcresult bundle.
get_file_coverageNur lesendShow 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. | Aktion |
| stop_app_sim | Stop sim app. | Aktion |
| record_sim_video | Record sim video. | Aktion |
| clean | Clean build products. | Aktion |
| 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. | Nur lesend |
| list_schemes | List Xcode schemes. | Nur lesend |
| show_build_settings | Show build settings. | Nur lesend |
| get_app_bundle_id | Extract bundle id from .app. | Nur lesend |
| screenshot | Capture screenshot. | Nur lesend |
| 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. | Nur lesend |
| get_coverage_report | Show per-target code coverage from an xcresult bundle. | Nur lesend |
| get_file_coverage | Show function-level coverage and uncovered line ranges for a specific file. | Nur lesend |
Automatisierte Checks
Geluften am 16. Nov. 2026Vollständiger Bericht →Unsere automatisierten Checks bestanden. Das ist kein Security-Audit: Lies den Code und gib dem Server nur den minimal notwendigen Zugriff. Wie die Checks funktionieren
- Source Repository verknüpft und erreichbargetsentry/mobilebuildmcp is public and reachablegithub.com/getsentry/mobilebuildmcp ↗Bestanden
- Paket nennt dieses Repository als Quellemobilebuildmcp names getsentry/mobilebuildmcp as sourcenpmjs.com/package/mobilebuildmcp ↗Bestanden
- Build-Provenienz (Sigstore-Attestierung)Sigstore attestation for mobilebuildmcpnpmjs.com/package/mobilebuildmcp/v/2.7.1#provenance ↗Bestanden
- Open Source Lizenz (OSI)MITspdx.org/licenses/MIT.html ↗Bestanden
- Commit oder Release im letzten JahrLast commit or release 2026-11-13github.com/getsentry/mobilebuildmcp ↗Bestanden
- OpenSSF ScorecardNicht geprüft
- Package-Name ähnelt keinem populären PackageNo popular package one edit away from mobilebuildmcpBestanden
- Keine kritischen Advisories im Paket oder seinen AbhängigkeitenNicht geprüft
- Keine versteckten Anweisungen an das Modell24 tool descriptions and the README read; no override phrases, credential paths or hidden charactersBestanden
- Destruktive Tools sind markiertNo tool named like delete, drop or execBestanden
- Remote-Endpoint beantwortet den MCP-HandshakeNicht geprüft
README
Auf GitHub ansehenA 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.
MobileBuildMCP MCP Fragen
Wie füge ich MobileBuildMCP MCP zu Claude Code hinzu?
Führe claude mcp add mobilebuildmcp -- npx -y mobilebuildmcp mcp in deinem Terminal aus. Füge --scope user hinzu, damit der Server in jedem Projekt verfügbar ist.
Wie füge ich MobileBuildMCP MCP zu Cursor hinzu?
Öffne ~/.cursor/mcp.json und füge den Server unter mcpServers hinzu, mit der Cursor-Config aus dem Installationsabschnitt oben.
Welche Tools bietet MobileBuildMCP MCP?
Er stellt 24 Tools bereit, darunter session_show_defaults, session_use_defaults_profile, session_set_defaults, session_clear_defaults, list_sims.
Was macht MobileBuildMCP für iOS- und macOS-Projekte?
Es bietet MCP Tools und CLI-Befehle, mit denen Agents Xcode-Projekte für iOS und macOS bauen, testen und verwalten können, einschließlich Simulator-Builds und Test-Produkten.
Wie installiere ich MobileBuildMCP?
Installiere es via Homebrew über den getsentry tap oder global via npm mit mobilebuildmcp@latest; beides liefert dir das CLI und den MCP server.
Was sind die Systemanforderungen für MobileBuildMCP?
Es erfordert macOS 14.5 oder neuer und Xcode 16.x oder neuer, sowie Node.js 18.x oder neuer, sofern du es nicht via Homebrew installiert hast.
Kann ich mit MobileBuildMCP über die Kommandozeile für einen Simulator bauen?
Ja, das CLI enthält einen Simulator-Build-Befehl, der ein Scheme und einen Projektpfad entgegennimmt.
Sendet MobileBuildMCP Telemetrie?
Es nutzt Sentry nur für interne Runtime-Error-Telemetrie, und die Dokumentation beschreibt, wie man dem opt-out kann.