XcodeBuildMCP

Ein Model Context Protocol (MCP)-Server und CLI, der Werkzeuge für die Nutzung durch Agenten bei der Arbeit an iOS- und macOS-Projekten bereitstellt.

GitHub
6.5k

Was kann man mit XcodeBuildMCP MCP machen?

  • Build for simulator — Bitten Sie Ihre KI, eine iOS- oder macOS-App für einen bestimmten Simulator mit einem benannten Scheme und Projektpfad zu kompilieren.
  • Prepare test products — Lassen Sie Ihre KI portable Test-Bundles generieren, ohne Tests auszuführen, und zielen Sie dabei auf einen gewählten Simulator.
  • Run prepared tests — Weisen Sie Ihre KI an, zuvor erstellte Testprodukte auf einem angegebenen Simulator auszuführen.
  • List available tools — Bitten Sie Ihre KI, den vollständigen Satz an CLI-Befehlen und MCP-Serverfunktionen anzuzeigen, die sie aufrufen kann.
  • Check for updates — Fordern Sie Ihre KI auf, die installierte Version zu überprüfen und das Tool bei Bedarf direkt zu aktualisieren.

Dokumentation

Ein Model Context Protocol (MCP) Server und CLI, der Werkzeuge für die Nutzung durch Agenten bei der Arbeit an iOS- und macOS-Projekten bereitstellt.

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

Installation

MobileBuildMCP wird als einzelnes Paket mit zwei Modi geliefert: eine CLI für die direkte Terminalnutzung und einen MCP-Server für KI-Codierungsagenten. Beide Installationsmethoden bieten Ihnen beides.

Option A — Homebrew

brew tap getsentry/xcodebuildmcp
brew install mobilebuildmcp

Option B — npm (Node.js 18+)

npm install -g mobilebuildmcp@latest

Überprüfen Sie eine der Installationen:

mobilebuildmcp --help

Verbinden Sie Ihren MCP-Client

Vorgefertigte Konfigurationsausschnitte für Cursor, Claude Code und Codex finden Sie auf der offiziellen Dokumentationsseite MCP Clients. Die meisten Clients können den MCP-Server auch bei Bedarf über npx -y mobilebuildmcp@latest mcp ohne globale Installation ausführen.

Anforderungen

  • macOS 14.5 oder neuer
  • Xcode 16.x oder neuer
  • Node.js 18.x oder neuer (für die Homebrew-Installation nicht erforderlich)

Fähigkeiten

MobileBuildMCP enthält jetzt zwei optionale Agentenfähigkeiten:

  • MCP-Fähigkeit: Bereitet den Agenten mit Anweisungen zur Nutzung der Werkzeuge des MCP-Servers vor (optional bei Verwendung des MCP-Servers).

  • CLI-Fähigkeit: Bereitet den Agenten mit Anweisungen zur Navigation in der CLI vor (empfohlen bei Verwendung der CLI).

Zur Installation mit einer globalen Binärdatei:

mobilebuildmcp init

Oder installieren Sie direkt über npx ohne globale Installation:

npx -y mobilebuildmcp@latest init

Weitere Informationen zur Installation von Fähigkeiten finden Sie unter Agent Skills.

Hinweise

  • MobileBuildMCP fordert xcodebuild auf, die Makrovalidierung zu überspringen, um Fehler beim Erstellen von Projekten zu vermeiden, die Swift-Makros verwenden.
  • Gerätewerkzeuge erfordern eine in Xcode konfigurierte Codesignierung. Siehe Device Code Signing.

Datenschutz

MobileBuildMCP verwendet Sentry nur für die interne Telemetrie von Laufzeitfehlern. Details und Anweisungen zum Opt-out finden Sie unter Privacy & Telemetry.

CLI

MobileBuildMCP bietet eine einheitliche Befehlszeilenschnittstelle. Der Unterbefehl mcp startet den MCP-Server, während alle anderen Befehle direkten Terminalzugriff auf die Werkzeuge bieten:

# 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"

Nach Updates suchen und direkt aktualisieren:

mobilebuildmcp upgrade --check
mobilebuildmcp upgrade --yes

Die CLI verwendet einen Daemon pro Arbeitsbereich für zustandsbehaftete Vorgänge (Protokollerfassung, Debugging usw.), der bei Bedarf automatisch startet. Die vollständige Dokumentation finden Sie im CLI-Leitfaden.

Dokumentation

Lizenz

Dieses Projekt ist unter der MIT-Lizenz lizenziert – siehe die Datei LICENSE für Details. Hinweise zu Lizenzen Dritter finden Sie in der Datei THIRD_PARTY_LICENSES. Zuordnungen für npm-Pakete finden Sie in der Datei THIRD_PARTY_PACKAGE_LICENSES.