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.2k

Was kann man mit Xcode Build MCP machen?

  • Erstelle eine App für den Simulator — Bitte den Agenten, simulator build mit einem Scheme und Projektpfad auszuführen, um dein iOS- oder macOS-Projekt zu kompilieren.
  • Führe Tests auf einem bestimmten Simulator aus — Verwende simulator test mit einem Testproduktpfad und Simulatornamen, um zuvor vorbereitete Testbündel auszuführen.
  • Bereite Testprodukte vor, ohne sie auszuführen — Rufe simulator build mit --build-for-testing und einem --test-products-path auf, um portable .xctestproducts-Bündel zu erzeugen.
  • Starte den MCP-Server für einen KI-Client — Führe den Unterbefehl mcp aus, damit dein Coding-Agent über das MCP-Protokoll auf alle Build- und Testwerkzeuge zugreifen kann.
  • Liste verfügbare Werkzeuge über die CLI auf — Verwende den Befehl tools, um herauszufinden, welche Operationen in der aktuellen Umgebung verfügbar sind.
  • Suche nach Updates und wende sie an — Führe upgrade --check oder upgrade --yes aus, um die CLI direkt zu aktualisieren.

Dokumentation

XcodeBuild MCP

Ein Model Context Protocol (MCP)-Server und CLI, der Werkzeuge für den Agenteneinsatz 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

XcodeBuildMCP wird als ein einzelnes Paket mit zwei Modi ausgeliefert: einer CLI für die direkte Terminalnutzung und einem MCP-Server für KI-Coding-Agenten. Beide Installationsmethoden bieten Ihnen beides.

Option A — Homebrew

brew tap getsentry/xcodebuildmcp
brew install xcodebuildmcp

Option B — npm (Node.js 18+)

npm install -g xcodebuildmcp@latest

Überprüfen Sie jede Installation:

xcodebuildmcp --help

Verbinden Sie Ihren MCP-Client

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

Voraussetzungen

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

Skills

XcodeBuildMCP enthält jetzt zwei optionale Agenten-Skills:

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

  • CLI Skill: Bereitet den Agenten mit Anweisungen zur Navigation in der CLI vor (empfohlen bei Verwendung der CLI).

Zur Installation mit einer globalen Binary:

xcodebuildmcp init

Oder installieren Sie direkt über npx ohne globale Installation:

npx -y xcodebuildmcp@latest init

Weitere Informationen zur Installation von Skills finden Sie unter Agent Skills.

Hinweise

  • XcodeBuildMCP fordert xcodebuild auf, die Makrovalidierung zu überspringen, um Fehler beim Erstellen von Projekten zu vermeiden, die Swift Macros verwenden.
  • Gerätewerkzeuge erfordern, dass die Codesignatur in Xcode konfiguriert ist. Siehe Device Code Signing.

Datenschutz

XcodeBuildMCP verwendet Sentry ausschließlich für interne Laufzeitfehler-Telemetrie. Details und Anweisungen zur Deaktivierung finden Sie unter Privacy & Telemetry.

CLI

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

# 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

# Prepare portable test products without running tests
xcodebuildmcp 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
xcodebuildmcp simulator test --test-products-path ./MyApp.xctestproducts --simulator-name "iPhone 17"

Auf Updates prüfen und direkt aktualisieren:

xcodebuildmcp upgrade --check
xcodebuildmcp upgrade --yes

Die CLI verwendet einen pro-Workspace-Daemon für zustandsbehaftete Operationen (Log-Erfassung, Debugging usw.), der bei Bedarf automatisch startet. Siehe den CLI guide für die vollständige Dokumentation.

Dokumentation

Lizenz

Dieses Projekt ist unter der MIT-Lizenz lizenziert – siehe die Datei LICENSE für Details. Für Hinweise zu Drittanbieterlizenzen siehe die Datei THIRD_PARTY_LICENSES für Details. Für npm-Paketzuschreibungen siehe die Datei THIRD_PARTY_PACKAGE_LICENSES für Details.