xcode-studio-mcp

Einheitlicher MCP-Server für Xcode + iOS-Simulator – Erstellen, Bereitstellen, Screenshots erstellen und Interaktion mit Ihrer iOS-App über Claude Code, Codex, Cursor oder einen beliebigen MCP-Client.

In Swift geschrieben. Einzelne Binärdatei. Keine Node/Python-Laufzeitumgebung erforderlich.

License: MIT Swift 6.0+ MCP

Warum existiert dieses Projekt?

Heutzutage benötigen Sie 2-3 separate Tools, um den vollständigen iOS-Entwicklungszyklus mit einem KI-Agenten durchzuführen. xcode-studio-mcp kombiniert diese in einem einzigen Tool:

Write code → Build → Deploy to Simulator → Screenshot → Tap/Type → Verify

Tools

Tool	Beschreibung
`xcode_build`	Erstellt ein Xcode-Projekt mit strukturierter Fehlerausgabe (Datei, Zeile, Spalte, Schweregrad, Nachricht)
`xcode_run`	Erstellt und startet eine App im iOS-Simulator
`simulator_screenshot`	Erfasst den Simulator-Bildschirm als PNG-Bild
`simulator_tap`	Tippt auf x,y-Koordinaten auf dem Simulator-Bildschirm
`simulator_type`	Gibt Text in das aktuell fokussierte Feld ein
`simulator_describe`	Ruft den Barrierefreiheitsbaum des aktuellen Bildschirms ab (JSON)

Tool-Parameter

`xcode_build`

Parameter	Erforderlich	Beschreibung
`project_path`	Ja	Pfad zum Xcode-Projektverzeichnis, `.xcodeproj` oder `.xcworkspace`
`scheme`	Nein	Build-Schema (wird automatisch erkannt, falls weggelassen)
`configuration`	Nein	`Debug` (Standard) oder `Release`
`destination`	Nein	Build-Ziel (standardmäßig der gestartete Simulator)

`xcode_run`

Parameter	Erforderlich	Beschreibung
`project_path`	Ja	Pfad zum Xcode-Projekt
`bundle_identifier`	Ja	App-Bundle-ID (z. B. `com.example.MyApp`)
`scheme`	Nein	Build-Schema (automatisch erkannt)
`simulator_udid`	Nein	Ziel-Simulator (standardmäßig der gestartete)

`simulator_screenshot`

Parameter	Erforderlich	Beschreibung
`simulator_udid`	Nein	Ziel-Simulator (standardmäßig der gestartete)

`simulator_tap`

Parameter	Erforderlich	Beschreibung
`x`	Ja	X-Koordinate
`y`	Ja	Y-Koordinate
`duration`	Nein	Haltedauer in Sekunden (für langes Drücken)
`simulator_udid`	Nein	Ziel-Simulator

`simulator_type`

Parameter	Erforderlich	Beschreibung
`text`	Ja	Einzugebender Text
`simulator_udid`	Nein	Ziel-Simulator

`simulator_describe`

Parameter	Erforderlich	Beschreibung
`simulator_udid`	Nein	Ziel-Simulator

Schnellstart

Voraussetzungen

macOS mit installiertem Xcode

Für UI-Interaktions-Tools (tap, type, describe):

brew tap facebook/fb && brew install idb-companion
pip3 install fb-idb

Build

git clone https://github.com/kevinswint/xcode-studio-mcp.git
cd xcode-studio-mcp
swift build -c release

Claude Code konfigurieren

Fügen Sie dies zu Ihren Claude Code MCP-Einstellungen hinzu:

{
  "mcpServers": {
    "xcode-studio-mcp": {
      "command": "/path/to/xcode-studio-mcp/.build/release/XcodeStudioMCP"
    }
  }
}

Beispiel-Workflow

You: Build and run my app at ~/Projects/MyApp
Claude: [calls xcode_build] Build succeeded with 0 errors
        [calls xcode_run] App launched (PID 12345)
        [calls simulator_screenshot] Here's what the app looks like...
        [calls simulator_describe] I can see a "Sign In" button and email/password fields
        [calls simulator_tap] Tapped the email field
        [calls simulator_type] Typed "test@example.com"
        [calls simulator_screenshot] Here's the current state...

Architektur

┌─────────────────────────────┐
│     MCP Protocol Layer      │  stdio transport (Swift MCP SDK)
├─────────────────────────────┤
│   Tool Implementations      │  6 tools, structured error output
├──────────┬──────────────────┤
│ xcodebuild│  simctl  │  idb │  native process calls
│  wrapper  │  wrapper │ CLI  │
└──────────┴──────────┴──────┘

In Swift geschrieben, ohne Abhängigkeiten von Node/Python-Laufzeitumgebungen (idb CLI wird nur für UI-Interaktions-Tools benötigt).

Roadmap

v0.1 (aktuell): Core-Build + Simulator-Tools
v1.0: Semantische UI-Navigation („Tippe auf den Anmelden-Button“), visueller Vergleich, Bearbeitung von Xcode-Projektdateien, zusammengesetzte Operationen, SwiftUI-Vorschau-Erfassung

Mitwirken

Pull Requests sind willkommen. Die Codebasis besteht aus ca. 750 Zeilen Swift, organisiert in Tools, Services und Models.

Lizenz

MIT

Projekt	Was es tut	Unterschied
XcodeBuildMCP	Nur Build + Test	Keine Simulator-UI-Interaktion
mobile-mcp	Plattformübergreifende Simulator-UI	Keine Xcode-Build-Unterstützung
ios-simulator-mcp	Simulator über IDB	Kein Build, hängt für alles von IDB ab

Xcode-Studio-MCP

xcode-studio-mcp

Warum existiert dieses Projekt?

Tools

Tool-Parameter

`xcode_build`

`xcode_run`

`simulator_screenshot`

`simulator_tap`

`simulator_type`

`simulator_describe`

Schnellstart

Voraussetzungen

Build

Claude Code konfigurieren

Beispiel-Workflow

Architektur

Roadmap

Verwandte Projekte

Mitwirken

Lizenz

Resources

Tools

Latest Blog Posts

MCP directory API