English Français العربية

Xcode Studio MCP

Communauté Autres

iOS development tools: build, run, screenshot and interact with the iOS Simulator.

Code source Documentation

Installation

Les étapes d'installation sont dans la documentation ci-dessous. Documentation

Documentation

Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.

Sommaire
  1. xcode-studio-mcp
  2. Why This Exists
  3. Tool Parameters
  4. Quick Start
  5. Example Workflow
  6. Architecture
  7. Roadmap
  8. Related Projects
  9. Contributing
  10. License

xcode-studio-mcp

Unified MCP server for Xcode + iOS Simulator — build, deploy, screenshot, and interact with your iOS app from Claude Code, Codex, Cursor, or any MCP client.

Built in Swift. Single binary. No Node/Python runtime required.

Why This Exists

Today you need 2-3 separate tools to do the full iOS dev loop with an AI agent. xcode-studio-mcp combines them into one:

Write code → Build → Deploy to Simulator → Screenshot → Tap/Type → Verify
Tools
ToolDescription
xcode_buildBuild an Xcode project with structured error output (file, line, column, severity, message)
xcode_runBuild and launch an app in the iOS Simulator
simulator_screenshotCapture the Simulator screen as a PNG image
simulator_tapTap at x,y coordinates on the Simulator screen
simulator_typeType text into the currently focused field
simulator_describeGet the accessibility tree of the current screen (JSON)

Tool Parameters

xcode_build
ParameterRequiredDescription
project_pathYesPath to Xcode project directory, .xcodeproj, or .xcworkspace
schemeNoBuild scheme (auto-detected if omitted)
configurationNoDebug (default) or Release
destinationNoBuild destination (defaults to booted simulator)
xcode_run
ParameterRequiredDescription
project_pathYesPath to Xcode project
bundle_identifierYesApp bundle ID (e.g. com.example.MyApp)
schemeNoBuild scheme (auto-detected)
simulator_udidNoTarget simulator (defaults to booted)
simulator_screenshot
ParameterRequiredDescription
simulator_udidNoTarget simulator (defaults to booted)
simulator_tap
ParameterRequiredDescription
xYesX coordinate
yYesY coordinate
durationNoHold duration in seconds (for long press)
simulator_udidNoTarget simulator
simulator_type
ParameterRequiredDescription
textYesText to type
simulator_udidNoTarget simulator
simulator_describe
ParameterRequiredDescription
simulator_udidNoTarget simulator

Quick Start

Prerequisites
  • macOS with Xcode installed
  • For UI interaction 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
Configure Claude Code

Add to your Claude Code MCP settings:

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

Example 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...

Architecture

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

Built in Swift with zero Node/Python runtime dependencies (idb CLI is only needed for UI interaction tools).

Roadmap

  • v0.1 (current): Core build + simulator tools
  • v1.0: Semantic UI navigation ("tap the Sign In button"), visual diff, Xcode project file manipulation, compound operations, SwiftUI preview capture
ProjectWhat It DoesDifference
XcodeBuildMCPBuild + test onlyNo simulator UI interaction
mobile-mcpCross-platform simulator UINo Xcode build support
ios-simulator-mcpSimulator via IDBNo build, depends on IDB for everything

xcode-studio-mcp combines build and interact into a single server.

Contributing

PRs welcome. The codebase is ~750 lines of Swift organized into Tools, Services, and Models.

License

MIT

Questions fréquentes

Qu'est-ce que Xcode Studio MCP ?

iOS development tools: build, run, screenshot and interact with the iOS Simulator.

Comment installer Xcode Studio MCP ?

Suivez les étapes d'installation de sa documentation, affichée sur cette page et dans son dépôt.

Xcode Studio MCP est-il open source ?

Oui. Son code est sur GitHub sous licence MIT.

Qui maintient Xcode Studio MCP ?

Il est publié par kevinswint. AI.tn le référence sans le maintenir ni le recommander.

Issu des listes communautaires awesome-mcp-servers et du dépôt GitHub du projet. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.