Hier sind die Xcode MCP-Nutzungsrichtlinien für KI-Agenten

name: xcode-mcp-for-pi-agent description: Richtlinien für die effiziente Nutzung der Xcode MCP-Tools über die mcporter CLI. Diese Skill sollte verwendet werden, um zu verstehen, wann Xcode MCP-Tools im Vergleich zu Standard-Tools verwendet werden sollten. Xcode MCP verbraucht viele Tokens - nur für Build, Test, Simulator, Preview und SourceKit-Diagnosen verwenden. Niemals für Datei-Lese-/Schreib-/Grep-Operationen verwenden. Diese Skill bei der Arbeit mit Xcode-Projekten, iOS/macOS-Builds, SwiftUI-Previews oder Apple-Plattformentwicklung verwenden. # Xcode MCP-Nutzungsrichtlinien Xcode MCP-Tools werden über die `mcporter` CLI aufgerufen, die MCP-Server mit standardmäßigen Befehlszeilen-Tools verbindet. Diese Skill definiert, wann Xcode MCP verwendet werden sollte und wann Standard-Tools bevorzugt werden. ## Einrichtung Xcode MCP muss in `~/.mcporter/mcporter.json` konfiguriert sein: ```json { "mcpServers": { "xcode": { "command": "xcrun", "args": ["mcpbridge"], "env": {} } } } ``` Verbindung überprüfen: ```bash mcporter list xcode ``` --- ## Aufrufen von Tools Alle Xcode MCP-Tools werden über mcporter aufgerufen: ```bash # Verfügbare Tools auflisten mcporter list xcode # Ein Tool mit key:value-Argumenten aufrufen mcporter call xcode.<tool_name> param1:value1 param2:value2 # Mit Funktionsaufruf-Syntax aufrufen mcporter call 'xcode.<tool_name>(param1: "value1", param2: "value2")' ``` --- ## Vollständige Xcode MCP-Tools-Referenz ### Fenster- und Projektverwaltung | Tool | mcporter call | Token-Kosten | |------|---------------|------------| | Offene Xcode-Fenster auflisten (tabIdentifier abrufen) | `mcporter call xcode.XcodeListWindows` | Niedrig | ### Build-Operationen | Tool | mcporter call | Token-Kosten | |------|---------------|------------| | Xcode-Projekt bauen | `mcporter call xcode.BuildProject` | Mittel | | Build-Log mit Fehlern/Warnungen abrufen | `mcporter call xcode.GetBuildLog` | Mittel | | Probleme im Issue Navigator auflisten | `mcporter call xcode.XcodeListNavigatorIssues` | Niedrig | ### Testen | Tool | mcporter call | Token-Kosten | |------|---------------|------------| | Verfügbare Tests aus dem Testplan abrufen | `mcporter call xcode.GetTestList` | Niedrig | | Alle Tests ausführen | `mcporter call xcode.RunAllTests` | Mittel | | Bestimmte Tests ausführen (bevorzugt) | `mcporter call xcode.RunSomeTests` | Mittel | ### Preview und Ausführung | Tool | mcporter call | Token-Kosten | |------|---------------|------------| | SwiftUI-Preview-Snapshot rendern | `mcporter call xcode.RenderPreview` | Mittel | | Code-Snippet im Dateikontext ausführen | `mcporter call xcode.ExecuteSnippet` | Mittel | ### Diagnosen | Tool | mcporter call | Token-Kosten | |------|---------------|------------| | Compiler-Diagnosen für bestimmte Datei abrufen | `mcporter call xcode.XcodeRefreshCodeIssuesInFile` | Niedrig | | SourceKit-Diagnosen (alle offenen Dateien) abrufen | `mcporter call xcode.getDiagnostics` | Niedrig | ### Dokumentation | Tool | mcporter call | Token-Kosten | |------|---------------|------------| | Apple Developer-Dokumentation durchsuchen | `mcporter call xcode.DocumentationSearch` | Niedrig | ### Dateioperationen (HOHE TOKEN - NIE VERWENDEN) | MCP-Tool | Stattdessen verwenden | Warum | |----------|-------------|-----| | `xcode.XcodeRead` | `Read`-Tool / `cat` | Hoher Token-Verbrauch | | `xcode.XcodeWrite` | `Write`-Tool | Hoher Token-Verbrauch | | `xcode.XcodeUpdate` | `Edit`-Tool | Hoher Token-Verbrauch | | `xcode.XcodeGrep` | `rg` / `grep` | Hoher Token-Verbrauch | | `xcode.XcodeGlob` | `find` / `glob` | Hoher Token-Verbrauch | | `xcode.XcodeLS` | `ls`-Befehl | Hoher Token-Verbrauch | | `xcode.XcodeRM` | `rm`-Befehl | Hoher Token-Verbrauch | | `xcode.XcodeMakeDir` | `mkdir`-Befehl | Hoher Token-Verbrauch | | `xcode.XcodeMV` | `mv`-Befehl | Hoher Token-Verbrauch | --- ## Empfohlene Workflows ### 1. Code-Änderungs- und Build-Flow ``` 1. Code durchsuchen -> rg "pattern" --type swift 2. Datei lesen -> Read-Tool / cat 3. Datei bearbeiten -> Edit-Tool 4. Syntaxprüfung -> mcporter call xcode.getDiagnostics 5. Build -> mcporter call xcode.BuildProject 6. Fehler prüfen -> mcporter call xcode.GetBuildLog (falls Build fehlschlägt) ``` ### 2. Test-Schreib- und Ausführungs-Flow ``` 1. Testdatei lesen -> Read-Tool / cat 2. Test schreiben/bearbeiten -> Edit-Tool 3. Testliste abrufen -> mcporter call xcode.GetTestList 4. Tests ausführen -> mcporter call xcode.RunSomeTests (bestimmte Tests) 5. Ergebnisse prüfen -> Testausgabe überprüfen ``` ### 3. SwiftUI-Preview-Flow ``` 1. View bearbeiten -> Edit-Tool 2. Preview rendern -> mcporter call xcode.RenderPreview 3. Iterieren -> Nach Bedarf wiederholen ``` ### 4. Debug-Flow ``` 1. Diagnosen prüfen -> mcporter call xcode.getDiagnostics 2. Projekt bauen -> mcporter call xcode.BuildProject 3. Build-Log abrufen -> mcporter call xcode.GetBuildLog severity:error 4. Probleme beheben -> Edit-Tool 5. Neu bauen -> mcporter call xcode.BuildProject ``` ### 5. Dokumentationssuche ``` 1. Dokumentation durchsuchen -> mcporter call xcode.DocumentationSearch query:"SwiftUI NavigationStack" 2. Ergebnisse prüfen -> Informationen in der Implementierung verwenden ``` --- ## Fallback-Befehle (Wenn MCP oder mcporter nicht verfügbar) Wenn Xcode MCP getrennt ist, mcporter nicht installiert ist oder die Verbindung fehlschlägt, diese xcodebuild-Befehle direkt verwenden: ### Build-Befehle ```bash # Debug-Build (Simulator) - <SchemeName> durch das Schema Ihres Projekts ersetzen xcodebuild -scheme <SchemeName> -configuration Debug -sdk iphonesimulator build # Release-Build (Gerät) xcodebuild -scheme <SchemeName> -configuration Release -sdk iphoneos build # Build mit Workspace (für CocoaPods-Projekte) xcodebuild -workspace <ProjectName>.xcworkspace -scheme <SchemeName> -configuration Debug -sdk iphonesimulator build # Build mit Projektdatei xcodebuild -project <ProjectName>.xcodeproj -scheme <SchemeName> -configuration Debug -sdk iphonesimulator build # Verfügbare Schemata auflisten xcodebuild -list ``` ### Test-Befehle ```bash # Alle Tests ausführen xcodebuild test -scheme <SchemeName> -sdk iphonesimulator \ -destination "platform=iOS Simulator,name=iPhone 16" \ -configuration Debug # Bestimmte Testklasse ausführen xcodebuild test -scheme <SchemeName> -sdk iphonesimulator \ -destination "platform=iOS Simulator,name=iPhone 16" \ -only-testing:<TestTarget>/<TestClassName> # Bestimmte Testmethode ausführen xcodebuild test -scheme <SchemeName> -sdk iphonesimulator \ -destination "platform=iOS Simulator,name=iPhone 16" \ -only-testing:<TestTarget>/<TestClassName>/<testMethodName> # Mit Code-Abdeckung ausführen xcodebuild test -scheme <SchemeName> -sdk iphonesimulator \ -configuration Debug -enableCodeCoverage YES # Verfügbare Simulatoren auflisten xcrun simctl list devices available ``` ### Sauberer Build ```bash xcodebuild clean -scheme <SchemeName> ``` --- ## Schnellreferenz ### mcporter + Xcode MCP VERWENDEN für: - `xcode.BuildProject` - Bauen - `xcode.GetBuildLog` - Build-Fehler - `xcode.RunSomeTests` - Bestimmte Tests ausführen - `xcode.GetTestList` - Tests auflisten - `xcode.RenderPreview` - SwiftUI-Previews - `xcode.ExecuteSnippet` - Code-Ausführung - `xcode.DocumentationSearch` - Apple-Dokumentation - `xcode.XcodeListWindows` - tabIdentifier abrufen - `xcode.getDiagnostics` - SourceKit-Fehler ### Xcode MCP NIE VERWENDEN für: - `xcode.XcodeRead` -> `Read`-Tool / `cat` verwenden - `xcode.XcodeWrite` -> `Write`-Tool verwenden - `xcode.XcodeUpdate` -> `Edit`-Tool verwenden - `xcode.XcodeGrep` -> `rg` oder `grep` verwenden - `xcode.XcodeGlob` -> `find` / `glob` verwenden - `xcode.XcodeLS` -> `ls`-Befehl verwenden - Dateioperationen -> Standard-Tools verwenden --- ## Token-Effizienz-Zusammenfassung | Operation | Beste Wahl | Token-Auswirkung | |-----------|-------------|--------------| | Schnelle Syntaxprüfung | `mcporter call xcode.getDiagnostics` | Niedrig | | Vollständiger Build | `mcporter call xcode.BuildProject` | Mittel | | Bestimmte Tests ausführen | `mcporter call xcode.RunSomeTests` | Mittel | | Alle Tests ausführen | `mcporter call xcode.RunAllTests` | Hoch | | Datei lesen | `Read`-Tool / `cat` | Niedrig | | Datei bearbeiten | `Edit`-Tool | Niedrig | | Code durchsuchen | `rg` / `grep` | Niedrig | | Dateien auflisten | `ls` / `find` | Niedrig |