AIエージェントがMCPツールまたはCLIを通じて、iOSおよびmacOSのXcodeプロジェクトをビルド、テスト、管理できるようにします。
別名 getsentry/MobileBuildMCP
- スター
- 6,573
- ツール
- 24
- ダウンロード数(30日間)
- —
- 最新バージョン
- —
- 最終コミット
- 2026年11月13日
- ライセンス
- MIT
MobileBuildMCP MCPとは
AIエージェントがMCPツールまたはCLIを通じて、iOSおよびmacOSのXcodeプロジェクトをビルド、テスト、管理できるようにします。 24個のツールを提供しており、session_show_defaults, session_use_defaults_profile, session_set_defaultsなどがあります。
プロジェクトのREADMEから生成された概要
MobileBuildMCP MCP server について
MobileBuildMCPは、AIエージェントを通じてiOSおよびmacOSの開発ワークフローを管理することを可能にします。AIコーディングアシスタントとXcodeの架け橋となり、エージェントがプロジェクトを直接ビルド、テスト、管理できるようにします。開発者は、Claude CodeやCursorなどのクライアント向けの専用MCP serverとして利用することも、統合されたコマンドラインインターフェースを通じて操作することもできます。
インストールはHomebrewまたはnpmから可能で、システムにはmacOS 14.5以降とXcode 16.xが必要です。このツールには、Swift Macrosを使用しているプロジェクトでエラーが発生しないよう、ビルド中のマクロ検証をスキップする特定のロジックが含まれています。CLIを使用する場合、ワークスペースごとのデーモンがログのキャプチャやデバッグなどのステートフルなタスクを処理します。サーバーはエージェントによる利用を想定して設計されていますが、手動でのプロジェクト管理のための標準的なターミナルツールとしても機能します。
できること
- 1シミュレータ向けのプロジェクトビルド特定のXcode schemeをシミュレータターゲット向けにコンパイルするようAIエージェントに指示します。
- 2テスト製品の準備テストを即座に実行することなく、ポータブルなテスト製品を生成するようエージェントに指示します。
- 3自動テストの実行以前に準備されたテスト製品を、特定のシミュレータ名でAIに実行させます。
- 4ソフトウェアアップデートの管理CLIを使用して、ツールのバージョンアップを確認し、適用します。
プロジェクトの README から作成されています。すべてのユースケースは、その引用と照らし合わせて確認されています。
MobileBuildMCP MCPのインストール方法
フォーマット検証日 2026年11月10日Cursor に追加Gooseに追加Claude CodeにMobileBuildMCP MCPをインストール
$ claude mcp add mobilebuildmcp -- npx -y mobilebuildmcp mcpCursorにMobileBuildMCP MCPをインストール
~/.cursor/mcp.json
{
"mcpServers": {
"mobilebuildmcp": {
"command": "npx",
"args": [
"-y",
"mobilebuildmcp",
"mcp"
]
}
}
}VS CodeにMobileBuildMCP MCPをインストール
.vscode/mcp.json
{
"servers": {
"mobilebuildmcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"mobilebuildmcp",
"mcp"
]
}
}
}VS Code CLIにMobileBuildMCP MCPをインストール
$ code --add-mcp '{"name":"mobilebuildmcp","type":"stdio","command":"npx","args":["-y","mobilebuildmcp","mcp"]}'Claude DesktopにMobileBuildMCP MCPをインストール
claude_desktop_config.json
{
"mcpServers": {
"mobilebuildmcp": {
"command": "npx",
"args": [
"-y",
"mobilebuildmcp",
"mcp"
]
}
}
}CodexにMobileBuildMCP MCPをインストール
$ codex mcp add mobilebuildmcp -- npx -y mobilebuildmcp mcpCodex config.tomlにMobileBuildMCP MCPをインストール
~/.codex/config.toml
[mcp_servers.mobilebuildmcp] command = "npx" args = ["-y", "mobilebuildmcp", "mcp"]
Gemini CLIにMobileBuildMCP MCPをインストール
$ gemini mcp add -s user mobilebuildmcp npx -- -y mobilebuildmcp mcpGemini settings.jsonにMobileBuildMCP MCPをインストール
~/.gemini/settings.json
{
"mcpServers": {
"mobilebuildmcp": {
"command": "npx",
"args": [
"-y",
"mobilebuildmcp",
"mcp"
]
}
}
}HostedMCP が 2026年11月16日 に起動を確認
mobilebuildmcp 2.7.1 をネットワークもキーもない隔離コンテナでこのコマンドで起動しました。応答があり、24個のツールが一覧表示されました。
MobileBuildMCP MCPツール 24
tools/list でサーバーから取得session_show_defaults読み取り専用Show current active defaults. Required before your first build/run/test call in a session — do not assume defaults are configured.
session_use_defaults_profileアクションSwitch the active session defaults profile.
session_set_defaultsアクションSet session defaults for the active profile, or for a specified profile and make it active.
session_clear_defaultsアクションClear session defaults for the active profile or a specified profile.
list_sims読み取り専用List iOS simulators.
boot_simアクションBoot iOS simulator for manual/non-build flows. Not required before simulator build-and-run (build_run_sim).
open_sim読み取り専用Open the simulator frontend for visibility and manual workflows. Not required before simulator build-and-run (build_run_sim).
build_simアクションBuild for iOS sim (compile-only, no launch).
build_run_simアクションBuild, install, and launch on iOS Simulator, booting it when needed. Runtime logs are captured automatically and the log file path is included in the response. Preferred single-step run tool when defaults are set.
test_simアクションTest on iOS sim.
get_sim_app_path読み取り専用Get sim built app path.
install_app_simアクションInstall app on sim.
| session_show_defaults | Show current active defaults. Required before your first build/run/test call in a session — do not assume defaults are configured. | 読み取り専用 |
| session_use_defaults_profile | Switch the active session defaults profile. | アクション |
| session_set_defaults | Set session defaults for the active profile, or for a specified profile and make it active. | アクション |
| session_clear_defaults | Clear session defaults for the active profile or a specified profile. | アクション |
| list_sims | List iOS simulators. | 読み取り専用 |
| boot_sim | Boot iOS simulator for manual/non-build flows. Not required before simulator build-and-run (build_run_sim). | アクション |
| open_sim | Open the simulator frontend for visibility and manual workflows. Not required before simulator build-and-run (build_run_sim). | 読み取り専用 |
| build_sim | Build for iOS sim (compile-only, no launch). | アクション |
| build_run_sim | Build, install, and launch on iOS Simulator, booting it when needed. Runtime logs are captured automatically and the log file path is included in the response. Preferred single-step run tool when defaults are set. | アクション |
| test_sim | Test on iOS sim. | アクション |
| get_sim_app_path | Get sim built app path. | 読み取り専用 |
| install_app_sim | Install app on sim. | アクション |
24個のツールをすべて表示ツールを折りたたむ
launch_app_simアクションLaunch app on simulator. Runtime logs are captured automatically and the log file path is included in the response.
stop_app_simアクションStop sim app.
record_sim_videoアクションRecord sim video.
cleanアクションClean build products.
discover_projs読み取り専用Scans a directory (defaults to workspace root) to find Xcode project (.xcodeproj) and workspace (.xcworkspace) files. Use when project/workspace path is unknown.
list_schemes読み取り専用List Xcode schemes.
show_build_settings読み取り専用Show build settings.
get_app_bundle_id読み取り専用Extract bundle id from .app.
screenshot読み取り専用Capture screenshot.
snapshot_ui読み取り専用Capture a semantic rs/1 runtime UI snapshot with elementRef targets. Observe once, use tap for one target or batch for multiple same-screen targets, and refresh after navigation, scrolling, sheet changes, or obvious layout changes.
get_coverage_report読み取り専用Show per-target code coverage from an xcresult bundle.
get_file_coverage読み取り専用Show function-level coverage and uncovered line ranges for a specific file.
| launch_app_sim | Launch app on simulator. Runtime logs are captured automatically and the log file path is included in the response. | アクション |
| stop_app_sim | Stop sim app. | アクション |
| record_sim_video | Record sim video. | アクション |
| clean | Clean build products. | アクション |
| discover_projs | Scans a directory (defaults to workspace root) to find Xcode project (.xcodeproj) and workspace (.xcworkspace) files. Use when project/workspace path is unknown. | 読み取り専用 |
| list_schemes | List Xcode schemes. | 読み取り専用 |
| show_build_settings | Show build settings. | 読み取り専用 |
| get_app_bundle_id | Extract bundle id from .app. | 読み取り専用 |
| screenshot | Capture screenshot. | 読み取り専用 |
| snapshot_ui | Capture a semantic rs/1 runtime UI snapshot with elementRef targets. Observe once, use tap for one target or batch for multiple same-screen targets, and refresh after navigation, scrolling, sheet changes, or obvious layout changes. | 読み取り専用 |
| get_coverage_report | Show per-target code coverage from an xcresult bundle. | 読み取り専用 |
| get_file_coverage | Show function-level coverage and uncovered line ranges for a specific file. | 読み取り専用 |
自動チェック
実行日 2026年11月16日完全なレポート →自動チェックに合格しました。これはセキュリティ監査ではありません。コードを読み、サーバーに必要最小限のアクセス権を与えてください。 チェックの仕組み
- ソースリポジトリがリンクされており、アクセス可能getsentry/mobilebuildmcp is public and reachablegithub.com/getsentry/mobilebuildmcp ↗合格
- パッケージがこのリポジトリをソースとして指定mobilebuildmcp names getsentry/mobilebuildmcp as sourcenpmjs.com/package/mobilebuildmcp ↗合格
- ビルドの来歴 (Sigstore 証明)Sigstore attestation for mobilebuildmcpnpmjs.com/package/mobilebuildmcp/v/2.7.1#provenance ↗合格
- オープンソースライセンス (OSI)MITspdx.org/licenses/MIT.html ↗合格
- 過去1年以内にコミットまたはリリースありLast commit or release 2026-11-13github.com/getsentry/mobilebuildmcp ↗合格
- OpenSSF Scorecard未チェック
- パッケージ名が有名なパッケージに酷似していないNo popular package one edit away from mobilebuildmcp合格
- パッケージおよびその依存関係に重大な勧告なし未チェック
- モデルへの隠れた指示がない24 tool descriptions and the README read; no override phrases, credential paths or hidden characters合格
- 破壊的なツールがラベル付けされているNo tool named like delete, drop or exec合格
- リモートエンドポイントが MCP ハンドシェイクに応答未チェック
README
GitHubで見るA Model Context Protocol (MCP) server and CLI that provides tools for agent use when working on iOS and macOS projects.
Installation
MobileBuildMCP ships as a single package with two modes: a CLI for direct terminal use and an MCP server for AI coding agents. Either install method gives you both.
Option A — Homebrew
brew tap getsentry/xcodebuildmcp
brew install mobilebuildmcp
Option B — npm (Node.js 18+)
npm install -g mobilebuildmcp@latest
Verify either install:
mobilebuildmcp --help
Connect your MCP client
Drop-in config snippets for Cursor, Claude Code, Codex, can be found in the official docs page MCP Clients. Most clients can also run the MCP server on demand via npx -y mobilebuildmcp@latest mcp without a global install.
Requirements
- macOS 14.5 or later
- Xcode 16.x or later
- Node.js 18.x or later (not required for Homebrew installation)
Skills
MobileBuildMCP now includes two optional agent skills:
-
MCP Skill: Primes the agent with instructions on how to use the MCP server's tools (optional when using the MCP server).
-
CLI Skill: Primes the agent with instructions on how to navigate the CLI (recommended when using the CLI).
To install with a global binary:
mobilebuildmcp init
Or install directly via npx without a global install:
npx -y mobilebuildmcp@latest init
For further information on installing skills, see Agent Skills.
Notes
- MobileBuildMCP requests xcodebuild to skip macro validation to avoid errors when building projects that use Swift Macros.
- Device tools require code signing to be configured in Xcode. See Device Code Signing.
Privacy
MobileBuildMCP uses Sentry for internal runtime error telemetry only. For details and opt-out instructions, see Privacy & Telemetry.
CLI
MobileBuildMCP provides a unified command-line interface. The mcp subcommand starts the MCP server, while all other commands provide direct terminal access to tools:
# Install globally
npm install -g mobilebuildmcp@latest
# Start the MCP server (for MCP clients)
mobilebuildmcp mcp
# List available tools
mobilebuildmcp tools
# Build for simulator
mobilebuildmcp simulator build --scheme MyApp --project-path ./MyApp.xcodeproj
# Prepare portable test products without running tests
mobilebuildmcp simulator build --scheme MyApp --project-path ./MyApp.xcodeproj --simulator-name "iPhone 17" --build-for-testing --test-products-path ./MyApp.xctestproducts
# Run previously prepared test products
mobilebuildmcp simulator test --test-products-path ./MyApp.xctestproducts --simulator-name "iPhone 17"
Check for updates and upgrade in place:
mobilebuildmcp upgrade --check
mobilebuildmcp upgrade --yes
The CLI uses a per-workspace daemon for stateful operations (log capture, debugging, etc.) that auto-starts when needed. See the CLI guide for full documentation.
Documentation
- Installation: https://github.com/getsentry/xcodebuildmcp.com/blob/main/app/docs/_content/installation.mdx
- Setup: https://github.com/getsentry/xcodebuildmcp.com/blob/main/app/docs/_content/setup.mdx
- MCP clients: https://github.com/getsentry/xcodebuildmcp.com/blob/main/app/docs/_content/clients.mdx
- CLI usage: https://github.com/getsentry/xcodebuildmcp.com/blob/main/app/docs/_content/cli.mdx
- Configuration and options: https://github.com/getsentry/xcodebuildmcp.com/blob/main/app/docs/_content/configuration.mdx
- Tools reference: https://github.com/getsentry/xcodebuildmcp.com/blob/main/app/docs/_content/tools.mdx
- Troubleshooting: https://github.com/getsentry/xcodebuildmcp.com/blob/main/app/docs/_content/troubleshooting.mdx
- Privacy: https://github.com/getsentry/xcodebuildmcp.com/blob/main/app/docs/_content/privacy.mdx
- Skills: https://github.com/getsentry/xcodebuildmcp.com/blob/main/app/docs/_content/skills.mdx
- Contributing: https://github.com/getsentry/xcodebuildmcp.com/blob/main/app/docs/_content/contributing.mdx
Licence
This project is licensed under the MIT License - see the LICENSE file for details. For third-party licensing notices see the THIRD_PARTY_LICENSES file for details. For npm package attributions see the THIRD_PARTY_PACKAGE_LICENSES file for details.
MobileBuildMCP MCPのよくある質問
MobileBuildMCP MCPをClaude Codeに追加するには
ターミナルでclaude mcp add mobilebuildmcp -- npx -y mobilebuildmcp mcpを実行します。すべてのプロジェクトで利用するには--scope userを追加します。
MobileBuildMCP MCPをCursorに追加するには
~/.cursor/mcp.jsonを開き、上記のインストールセクションに示すCursor設定を使ってmcpServersの下にサーバーを追加します。
MobileBuildMCP MCPが提供するツールは
24個のツールを提供しており、session_show_defaults, session_use_defaults_profile, session_set_defaults, session_clear_defaults, list_simsなどがあります。
MobileBuildMCPはiOSおよびmacOSプロジェクトに対して何ができますか?
エージェントがiOSおよびmacOS向けのXcodeプロジェクトをビルド、テスト、管理するためのMCPツールとCLIコマンドを提供します。これには、シミュレータ向けのビルドやテスト製品の作成も含まれます。
MobileBuildMCPのインストール方法を教えてください。
Homebrewのgetsentry tapを使用するか、npmでmobilebuildmcp@latestをグローバルにインストールしてください。どちらの方法でもCLIとMCP serverの両方が利用可能になります。
MobileBuildMCPのシステム要件は何ですか?
macOS 14.5以降、Xcode 16.x以降、およびNode.js 18.x以降が必要です(Homebrew経由でインストールした場合を除く)。
MobileBuildMCPを使用して、コマンドラインからシミュレータ向けのビルドはできますか?
はい、CLIにはschemeとプロジェクトパスを指定して実行できるシミュレータビルドコマンドが含まれています。
MobileBuildMCPはテレメトリを送信しますか?
内部的なランタイムエラーのテレメトリにのみSentryを使用します。ドキュメントにはオプトアウトの方法が記載されています。