Skip to main content
Glama
deenesjakoruzh
kevinswint

Xcode-Studio-MCP

by kevinswint
OverviewSchemaRelated ServersScoreDiscussions
Local

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)

Related MCP server: xcforge

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

Verwandte Projekte

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 kombiniert Build und Interaktion in einem einzigen Server.

Mitwirken

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

Lizenz

MIT

Install Server
A
license - permissive license
A
quality
C
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
–Release cycle
1Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

Related MCP Servers

View all related MCP servers

Related MCP Connectors

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/kevinswint/xcode-studio-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server