Xcode + iOS Simulator用統合MCPサーバー — Claude Code、Codex、Cursor、または任意のMCPクライアントからiOSアプリのビルド、デプロイ、スクリーンショット撮影、操作が可能です。
Swiftで構築。シングルバイナリ。Node/Pythonランタイムは不要です。
現在、AIエージェントでiOS開発の全ループを行うには2〜3個の別々のツールが必要です。xcode-studio-mcpはそれらを1つに統合します：
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 │
└──────────┴──────────┴──────┘Swiftで構築されており、Node/Pythonランタイムへの依存関係はゼロです（idb CLIはUI操作ツールにのみ必要です）。
v0.1 (現在): コアビルド + シミュレーターツール
v1.0: セマンティックUIナビゲーション（「サインインボタンをタップ」）、ビジュアル差分、Xcodeプロジェクトファイルの操作、複合操作、SwiftUIプレビューキャプチャ
プロジェクト | 何をするものか | 違い |
ビルド + テストのみ | シミュレーターのUI操作なし | |
クロスプラットフォームのシミュレーターUI | Xcodeビルドサポートなし | |
IDB経由のシミュレーター | ビルドなし、すべてをIDBに依存 |
xcode-studio-mcpは、ビルドと操作を単一のサーバーに統合します。
プルリクエストを歓迎します。コードベースは約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.
