English Français العربية

Xcode Studio MCP

مجتمعي أخرى

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

الشيفرة المصدرية التوثيق

التثبيت

خطوات التثبيت موجودة في التوثيق أدناه. التوثيق

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  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

الأسئلة الشائعة

ما هو Xcode Studio MCP؟

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

كيف أثبّت Xcode Studio MCP؟

اتبع خطوات التثبيت في توثيقه المعروض في هذه الصفحة وفي مستودعه.

هل Xcode Studio MCP مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون Xcode Studio MCP؟

ينشره kevinswint. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من القوائم المجتمعية awesome-mcp-servers ومستودع المشروع على GitHub. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.