Xcode

Xcode 26.3+ bietet einen integrierten MCP-Server, über den Cursor direkt auf deine Xcode-Projekte zugreifen kann. Der Cursor-Agent kann Dateien lesen und bearbeiten, Builds starten, Tests ausführen, SwiftUI-Vorschauen erfassen und Apples Dokumentation durchsuchen – ganz ohne den Editor zu verlassen.

Das funktioniert über xcrun mcpbridge, eine Binärdatei, die Apple mit Xcode ausliefert und MCP-Protokollnachrichten in die interne XPC-Schicht von Xcode übersetzt. Du konfigurierst sie einmal, und Cursor behandelt die 20 integrierten Tools von Xcode wie jeden anderen MCP-Server.

Voraussetzungen

• macOS mit installiertem Xcode 26.3 oder neuer
• Ein kostenpflichtiger Cursor-Plan
• Ein in Xcode geöffnetes Xcode-Projekt (Xcode muss geöffnet sein)

MCP in Xcode aktivieren

Bevor Cursor eine Verbindung herstellen kann, aktivieren Sie die MCP-Bridge von Xcode:

Cursor einrichten

Wähle die Methode, die am besten zu deinem Workflow passt.

Option 1: MCP-Einstellungs-UI

Option 2: mcp.json

Füge deiner MCP-Konfigurationsdatei einen Eintrag hinzu:

{  "mcpServers": {    "xcode-tools": {      "command": "xcrun",      "args": ["mcpbridge"]    }  }}

Option 3: Cursor-CLI

Wenn du die Cursor-CLI verwendest, registriere den Server im Terminal:

agent mcp add xcode-tools -- xcrun mcpbridge

Die CLI verwendet dieselbe MCP-Konfiguration wie der Editor, sodass der Server in beiden angezeigt wird.

Verfügbare Tools

Xcode bietet 20 MCP-Tools in fünf Kategorien:

Dateioperationen

• XcodeRead - Dateiinhalte lesen (bis zu 600 Zeilen pro Aufruf; für größere Dateien mit Offset/Limit)
• XcodeWrite - Dateien erstellen oder überschreiben
• XcodeUpdate - Gezielte Änderungen an vorhandenen Dateien vornehmen
• XcodeGrep - Dateiinhalte mit regulären Ausdrücken durchsuchen
• XcodeGlob - Dateien anhand eines Musters finden
• XcodeLS - Verzeichnisinhalte auflisten
• XcodeMakeDir - Verzeichnisse erstellen
• XcodeRM - Dateien oder Verzeichnisse entfernen
• XcodeMV - Dateien verschieben oder umbenennen

Bauen und testen

• BuildProject - Aktives Schema bauen
• GetBuildLog - Build-Protokolle abrufen, filterbar nach Schweregrad, regulärem Ausdruck oder Datei-Glob
• RunAllTests - Gesamte Test-Suite ausführen
• RunSomeTests - Bestimmte Testklassen oder -methoden ausführen
• GetTestList - Verfügbare Tests auflisten

Diagnosen

• XcodeListNavigatorIssues – Warnungen und Fehler im Issue-Navigator anzeigen
• XcodeRefreshCodeIssuesInFile – Eine Datei erneut auf Code-Issues überprüfen

Intelligenz

• RenderPreview – Erfasst einen Screenshot einer SwiftUI-Vorschau
• DocumentationSearch – Durchsucht Apples Dokumentation und WWDC-Transkripte semantisch
• ExecuteSnippet – Führt ein Swift-Code-Snippet aus

Arbeitsbereich

• XcodeListWindows – Geöffnete Xcode-Fenster und -Tabs auflisten

Beispiel-Workflow

Ein typischer Workflow mit Cursor und Xcode sieht so aus:

1. Öffnen Sie Ihr Projekt in Cursor und Xcode
2. Bitten Sie den Cursor-Agenten, ein Feature hinzuzufügen oder einen Bug zu beheben
3. Der Agent verwendet XcodeRead und XcodeGrep, um Ihren Code zu verstehen
4. Er bearbeitet Dateien mit XcodeWrite oder XcodeUpdate
5. Er führt BuildProject aus, um nach Fehlern zu suchen, und liest die Ergebnisse mit GetBuildLog
6. Er führt mit RunSomeTests Tests aus, um die Änderung zu überprüfen
7. Er erstellt mit RenderPreview eine SwiftUI-Vorschau, um die UI zu prüfen

Sie bleiben die ganze Zeit in Cursor. Xcode übernimmt Kompilierung, Tests und Vorschauen im Hintergrund.

Cursor-CLI mit Xcode

Die Cursor-CLI funktioniert auch mit den MCP-Tools von Xcode. Das ist nützlich für Workflows ohne grafische Oberfläche, CI-Pipelines und Entwickler, die hauptsächlich im Terminal arbeiten.

# Agent mit verfügbaren Xcode-Tools ausführenagent "Add unit tests for the NetworkManager class"

Der Agent übernimmt den xcode-tools-MCP-Server aus deiner Konfiguration und nutzt dieselben Tools wie im Editor.

Fehlerbehebung

sudo xcode-select -s /Applications/Xcode.app/Contents/Developersudo xcodebuild -runFirstLaunch

xcrun --find mcpbridge

Verwandte Themen