XcodeBuildMCP

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

Installation

XcodeBuildMCP wird als 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 die Installation:

xcodebuildmcp --help

Verbinden Sie Ihren MCP-Client

Konfigurations-Snippets 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 xcodebuildmcp@latest mcp ausführen, ohne dass eine globale Installation erforderlich ist.

Related MCP server: MCP Xcode Server

Anforderungen

• 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: Versorgt den Agenten mit Anweisungen zur Verwendung der Tools des MCP-Servers (optional bei Verwendung des MCP-Servers).

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

Zur Installation mit einer globalen Binärdatei:

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 weist xcodebuild an, die Makro-Validierung zu überspringen, um Fehler beim Erstellen von Projekten zu vermeiden, die Swift-Makros verwenden.

• Gerätetools erfordern eine in Xcode konfigurierte Codesignierung. Siehe Device Code Signing.

Datenschutz

XcodeBuildMCP verwendet Sentry ausschließlich für interne Telemetriedaten zu Laufzeitfehlern. Details und Anweisungen zum Opt-out 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 die Tools 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

Suchen Sie nach Updates und führen Sie ein In-Place-Upgrade durch:

xcodebuildmcp upgrade --check
xcodebuildmcp upgrade --yes

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

Dokumentation

• Installation: https://xcodebuildmcp.com/docs/installation

• Einrichtung: https://xcodebuildmcp.com/docs/setup

• MCP-Clients: https://xcodebuildmcp.com/docs/clients

• CLI-Nutzung: https://xcodebuildmcp.com/docs/cli

• Konfiguration und Optionen: https://xcodebuildmcp.com/docs/configuration

• Tools-Referenz: https://xcodebuildmcp.com/docs/tools

• Fehlerbehebung: https://xcodebuildmcp.com/docs/troubleshooting

• Datenschutz: https://xcodebuildmcp.com/docs/privacy

• Skills: https://xcodebuildmcp.com/docs/skills

• Mitwirken: https://xcodebuildmcp.com/docs/contributing

Lizenz

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