Xcode + iOS 시뮬레이터를 위한 통합 MCP 서버 — Claude Code, Codex, Cursor 또는 모든 MCP 클라이언트에서 iOS 앱을 빌드, 배포, 스크린샷 촬영 및 상호 작용할 수 있습니다.
Swift로 빌드되었습니다. 단일 바이너리입니다. Node/Python 런타임이 필요하지 않습니다.
현재 AI 에이전트로 전체 iOS 개발 루프를 수행하려면 2~3개의 별도 도구가 필요합니다. xcode-studio-mcp는 이를 하나로 결합합니다:
Write code → Build → Deploy to Simulator → Screenshot → Tap/Type → Verify도구 | 설명 |
| 구조화된 오류 출력(파일, 행, 열, 심각도, 메시지)과 함께 Xcode 프로젝트 빌드 |
| iOS 시뮬레이터에서 앱 빌드 및 실행 |
| 시뮬레이터 화면을 PNG 이미지로 캡처 |
| 시뮬레이터 화면의 x,y 좌표 탭 |
| 현재 포커스된 필드에 텍스트 입력 |
| 현재 화면의 접근성 트리 가져오기 (JSON) |
Related MCP server: xcforge
xcode_build매개변수 | 필수 | 설명 |
| 예 | Xcode 프로젝트 디렉토리, |
| 아니요 | 빌드 스킴 (생략 시 자동 감지) |
| 아니요 |
|
| 아니요 | 빌드 대상 (기본값은 부팅된 시뮬레이터) |
xcode_run매개변수 | 필수 | 설명 |
| 예 | Xcode 프로젝트 경로 |
| 예 | 앱 번들 ID (예: |
| 아니요 | 빌드 스킴 (자동 감지) |
| 아니요 | 대상 시뮬레이터 (기본값은 부팅된 시뮬레이터) |
simulator_screenshot매개변수 | 필수 | 설명 |
| 아니요 | 대상 시뮬레이터 (기본값은 부팅된 시뮬레이터) |
simulator_tap매개변수 | 필수 | 설명 |
| 예 | X 좌표 |
| 예 | Y 좌표 |
| 아니요 | 누르고 있는 시간(초) (길게 누르기용) |
| 아니요 | 대상 시뮬레이터 |
simulator_type매개변수 | 필수 | 설명 |
| 예 | 입력할 텍스트 |
| 아니요 | 대상 시뮬레이터 |
simulator_describe매개변수 | 필수 | 설명 |
| 아니요 | 대상 시뮬레이터 |
Xcode가 설치된 macOS
UI 상호 작용 도구(tap, type, describe) 사용 시:
brew tap facebook/fb && brew install idb-companion
pip3 install fb-idbgit clone https://github.com/kevinswint/xcode-studio-mcp.git
cd xcode-studio-mcp
swift build -c releaseClaude Code MCP 설정에 추가하세요:
{
"mcpServers": {
"xcode-studio-mcp": {
"command": "/path/to/xcode-studio-mcp/.build/release/XcodeStudioMCP"
}
}
}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...┌─────────────────────────────┐
│ MCP Protocol Layer │ stdio transport (Swift MCP SDK)
├─────────────────────────────┤
│ Tool Implementations │ 6 tools, structured error output
├──────────┬──────────────────┤
│ xcodebuild│ simctl │ idb │ native process calls
│ wrapper │ wrapper │ CLI │
└──────────┴──────────┴──────┘Node/Python 런타임 의존성 없이 Swift로 빌드되었습니다 (idb CLI는 UI 상호 작용 도구에만 필요합니다).
v0.1 (현재): 핵심 빌드 + 시뮬레이터 도구
v1.0: 의미론적 UI 탐색 ("로그인 버튼 탭"), 시각적 차이 비교, Xcode 프로젝트 파일 조작, 복합 작업, SwiftUI 미리보기 캡처
프로젝트 | 기능 | 차이점 |
빌드 + 테스트 전용 | 시뮬레이터 UI 상호 작용 없음 | |
크로스 플랫폼 시뮬레이터 UI | Xcode 빌드 지원 없음 | |
IDB를 통한 시뮬레이터 | 빌드 기능 없음, 모든 기능이 IDB에 의존 |
xcode-studio-mcp는 빌드와 상호 작용을 단일 서버로 결합합니다.
PR을 환영합니다. 코드베이스는 도구, 서비스, 모델로 구성된 약 750줄의 Swift 코드로 이루어져 있습니다.
MIT
Get the accessibility tree of the current iOS Simulator screen as JSON. Useful for finding UI elements to interact with. Requires idb (pip3 install fb-idb).
Inputs: simulator_udid.
Capture a screenshot of the iOS Simulator screen. Returns the image as base64-encoded PNG.
Inputs: simulator_udid.
Tap at specific coordinates on the iOS Simulator screen. Requires idb (pip3 install fb-idb).
Inputs: x (required), y (required), duration, simulator_udid.
Type text into the currently focused field on the iOS Simulator. Requires idb (pip3 install fb-idb).
Inputs: text (required), simulator_udid.
Build an Xcode project or workspace. Returns structured diagnostics with file, line, column, severity, and message for each error/warning.
Inputs: project_path (required), configuration, destination, scheme.
Build an Xcode project and launch the app in the iOS Simulator. Returns build errors if the build fails, or a success message with the launched process ID.
Inputs: bundle_identifier (required), project_path (required), configuration, scheme, +1 more.
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Scored across 6 tools
Each tool targets a distinct action: building, running, and simulator interactions (screenshot, tap, type, describe) are clearly separated. There is no overlap in purpose, making it easy for an agent to select the correct tool.
Tools are grouped into two clear namespaces: 'xcode_' for build/run and 'simulator_' for simulator interactions. However, the same verb 'run' is used for xcode_run (launch app) while the simulator tools use direct action verbs (tap, type, describe). The pattern is readable but not perfectly uniform.
With only 6 tools, the set is well-scoped for core Xcode build/run and simulator interaction workflows. Each tool serves a distinct purpose, and no tool feels redundant or missing at this scale.
The set covers building, running, and basic UI interaction (via describe/tap/type). A minor gap is the lack of a tool to terminate the running app, and no way to list available simulators, but agents can work around this for common tasks.
Cloud iPhones and Macs with Xcode for AI agents: build, run and test iOS apps, use the screen.
Cloud iPhone Simulators for AI agents: build the Xcode project, read the screen, tap by label, test.
The cloud Mac alone, with Xcode, for AI agents: run commands, build and test, use the screen.
Build, run, and inspect iOS apps in disposable hosted Simulators from cloud coding agents.
