Memungkinkan AI agent untuk build, test, dan mengelola proyek Xcode iOS dan macOS melalui MCP tools atau CLI.
Juga dikenal sebagai getsentry/MobileBuildMCP
- Stars
- 6.573
- Tools
- 24
- Unduhan, 30 hari
- —
- Versi terbaru
- —
- Commit terakhir
- 13 Nov 2026
- Lisensi
- MIT
Apa itu MobileBuildMCP MCP?
Memungkinkan AI agent untuk build, test, dan mengelola proyek Xcode iOS dan macOS melalui MCP tools atau CLI. Server ini menyediakan 24 tool, seperti session_show_defaults, session_use_defaults_profile, session_set_defaults.
Ringkasan dibuat dari README proyek
Tentang MobileBuildMCP MCP server
MobileBuildMCP memungkinkan Anda mengelola workflow pengembangan iOS dan macOS melalui AI agent. Tool ini menyediakan jembatan antara AI coding assistant dan Xcode, sehingga agent dapat melakukan build, test, dan mengelola proyek secara langsung. Developer dapat menggunakannya sebagai MCP server khusus untuk client seperti Claude Code atau Cursor, atau berinteraksi dengannya melalui command-line interface yang terpadu.
Installation tersedia via Homebrew atau npm, dan sistem membutuhkan macOS 14.5 atau versi terbaru beserta Xcode 16.x. Tool ini menyertakan logika khusus untuk melewati macro validation saat build guna memastikan proyek yang menggunakan Swift Macros tidak mengalami error. Bagi pengguna CLI, sebuah daemon per-workspace menangani tugas-tugas stateful seperti log capture dan debugging. Meskipun server ini dirancang untuk penggunaan agentic, tool ini juga berfungsi sebagai terminal tool standar untuk manajemen proyek secara manual.
Apa yang bisa Anda lakukan dengannya
- 1Build proyek untuk simulatorMinta AI agent untuk mengompilasi Xcode scheme tertentu untuk target simulator.
- 2Siapkan produk testInstruksikan agent untuk membuat produk test yang portable tanpa langsung mengeksekusi test tersebut.
- 3Eksekusi automated testsBiarkan AI menjalankan produk test yang telah disiapkan sebelumnya pada nama simulator tertentu.
- 4Kelola update softwareGunakan CLI untuk mengecek dan menerapkan upgrade versi pada tool ini.
Ditulis berdasarkan README proyek. Setiap use case diperiksa terhadap kutipan dari README tersebut.
Cara menginstal MobileBuildMCP MCP
Format diverifikasi 10 Nov 2026Tambahkan ke CursorTambahkan ke GooseInstal MobileBuildMCP MCP di Claude Code
$ claude mcp add mobilebuildmcp -- npx -y mobilebuildmcp mcpInstal MobileBuildMCP MCP di Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"mobilebuildmcp": {
"command": "npx",
"args": [
"-y",
"mobilebuildmcp",
"mcp"
]
}
}
}Instal MobileBuildMCP MCP di VS Code
.vscode/mcp.json
{
"servers": {
"mobilebuildmcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"mobilebuildmcp",
"mcp"
]
}
}
}Instal MobileBuildMCP MCP di VS Code CLI
$ code --add-mcp '{"name":"mobilebuildmcp","type":"stdio","command":"npx","args":["-y","mobilebuildmcp","mcp"]}'Instal MobileBuildMCP MCP di Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"mobilebuildmcp": {
"command": "npx",
"args": [
"-y",
"mobilebuildmcp",
"mcp"
]
}
}
}Instal MobileBuildMCP MCP di Codex
$ codex mcp add mobilebuildmcp -- npx -y mobilebuildmcp mcpInstal MobileBuildMCP MCP di Codex config.toml
~/.codex/config.toml
[mcp_servers.mobilebuildmcp] command = "npx" args = ["-y", "mobilebuildmcp", "mcp"]
Instal MobileBuildMCP MCP di Gemini CLI
$ gemini mcp add -s user mobilebuildmcp npx -- -y mobilebuildmcp mcpInstal MobileBuildMCP MCP di Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"mobilebuildmcp": {
"command": "npx",
"args": [
"-y",
"mobilebuildmcp",
"mcp"
]
}
}
}Dijalankan oleh HostedMCP pada 16 Nov 2026
Kami menjalankan perintah ini untuk mobilebuildmcp 2.7.1 di container terisolasi tanpa jaringan dan tanpa key. Server menjawab dan mendaftar 24 tool.
Tool MobileBuildMCP MCP 24
Dibaca langsung dari server dengan tools/listsession_show_defaultsHanya bacaShow current active defaults. Required before your first build/run/test call in a session — do not assume defaults are configured.
session_use_defaults_profileAksiSwitch the active session defaults profile.
session_set_defaultsAksiSet session defaults for the active profile, or for a specified profile and make it active.
session_clear_defaultsAksiClear session defaults for the active profile or a specified profile.
list_simsHanya bacaList iOS simulators.
boot_simAksiBoot iOS simulator for manual/non-build flows. Not required before simulator build-and-run (build_run_sim).
open_simHanya bacaOpen the simulator frontend for visibility and manual workflows. Not required before simulator build-and-run (build_run_sim).
build_simAksiBuild for iOS sim (compile-only, no launch).
build_run_simAksiBuild, 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_simAksiTest on iOS sim.
get_sim_app_pathHanya bacaGet sim built app path.
install_app_simAksiInstall 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. | Hanya baca |
| session_use_defaults_profile | Switch the active session defaults profile. | Aksi |
| session_set_defaults | Set session defaults for the active profile, or for a specified profile and make it active. | Aksi |
| session_clear_defaults | Clear session defaults for the active profile or a specified profile. | Aksi |
| list_sims | List iOS simulators. | Hanya baca |
| boot_sim | Boot iOS simulator for manual/non-build flows. Not required before simulator build-and-run (build_run_sim). | Aksi |
| open_sim | Open the simulator frontend for visibility and manual workflows. Not required before simulator build-and-run (build_run_sim). | Hanya baca |
| build_sim | Build for iOS sim (compile-only, no launch). | Aksi |
| 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. | Aksi |
| test_sim | Test on iOS sim. | Aksi |
| get_sim_app_path | Get sim built app path. | Hanya baca |
| install_app_sim | Install app on sim. | Aksi |
Tampilkan semua 24 toolTampilkan lebih sedikit tool
launch_app_simAksiLaunch app on simulator. Runtime logs are captured automatically and the log file path is included in the response.
stop_app_simAksiStop sim app.
record_sim_videoAksiRecord sim video.
cleanAksiClean build products.
discover_projsHanya bacaScans a directory (defaults to workspace root) to find Xcode project (.xcodeproj) and workspace (.xcworkspace) files. Use when project/workspace path is unknown.
list_schemesHanya bacaList Xcode schemes.
show_build_settingsHanya bacaShow build settings.
get_app_bundle_idHanya bacaExtract bundle id from .app.
screenshotHanya bacaCapture screenshot.
snapshot_uiHanya bacaCapture 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_reportHanya bacaShow per-target code coverage from an xcresult bundle.
get_file_coverageHanya bacaShow 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. | Aksi |
| stop_app_sim | Stop sim app. | Aksi |
| record_sim_video | Record sim video. | Aksi |
| clean | Clean build products. | Aksi |
| 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. | Hanya baca |
| list_schemes | List Xcode schemes. | Hanya baca |
| show_build_settings | Show build settings. | Hanya baca |
| get_app_bundle_id | Extract bundle id from .app. | Hanya baca |
| screenshot | Capture screenshot. | Hanya baca |
| 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. | Hanya baca |
| get_coverage_report | Show per-target code coverage from an xcresult bundle. | Hanya baca |
| get_file_coverage | Show function-level coverage and uncovered line ranges for a specific file. | Hanya baca |
Pengecekan otomatis
Berjalan 16 Nov 2026Laporan lengkap →Lolos checks otomatis kami. Ini bukan audit keamanan: baca kodenya dan berikan server akses paling terbatas yang dibutuhkannya. Cara kerja checks
- Source repository terhubung dan dapat dijangkaugetsentry/mobilebuildmcp is public and reachablegithub.com/getsentry/mobilebuildmcp ↗Lolos
- Nama paket mencantumkan repositori ini sebagai sumbernyamobilebuildmcp names getsentry/mobilebuildmcp as sourcenpmjs.com/package/mobilebuildmcp ↗Lolos
- Provenance build (atestasi Sigstore)Sigstore attestation for mobilebuildmcpnpmjs.com/package/mobilebuildmcp/v/2.7.1#provenance ↗Lolos
- Lisensi open source (OSI)MITspdx.org/licenses/MIT.html ↗Lolos
- Ada commit atau release dalam satu tahun terakhirLast commit or release 2026-11-13github.com/getsentry/mobilebuildmcp ↗Lolos
- OpenSSF ScorecardTidak diperiksa
- Nama package tidak mirip dengan package populerNo popular package one edit away from mobilebuildmcpLolos
- Tidak ada advisory kritis pada paket atau dependensinyaTidak diperiksa
- Tidak ada instruksi tersembunyi untuk model24 tool descriptions and the README read; no override phrases, credential paths or hidden charactersLolos
- Tools yang bersifat destruktif telah diberi labelNo tool named like delete, drop or execLolos
- Endpoint remote merespons handshake MCPTidak diperiksa
README
Lihat di GitHubA 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.
Pertanyaan tentang MobileBuildMCP MCP
Bagaimana cara menambahkan MobileBuildMCP MCP ke Claude Code?
Jalankan claude mcp add mobilebuildmcp -- npx -y mobilebuildmcp mcp di terminal Anda. Tambahkan --scope user agar tersedia di semua proyek.
Bagaimana cara menambahkan MobileBuildMCP MCP ke Cursor?
Buka ~/.cursor/mcp.json dan tambahkan server di bawah mcpServers, menggunakan config Cursor yang ditunjukkan di bagian instalasi di atas.
Tool apa yang disediakan MobileBuildMCP MCP?
Server ini menyediakan 24 tool, termasuk session_show_defaults, session_use_defaults_profile, session_set_defaults, session_clear_defaults, list_sims.
Apa yang dilakukan MobileBuildMCP untuk proyek iOS dan macOS?
MobileBuildMCP menyediakan MCP tools dan perintah CLI yang memungkinkan agent untuk build, test, dan mengelola proyek Xcode untuk iOS dan macOS, termasuk simulator builds dan produk test.
Bagaimana cara install MobileBuildMCP?
Install melalui Homebrew dengan getsentry tap atau via npm secara global dengan mobilebuildmcp@latest; keduanya memberikan Anda CLI dan MCP server.
Apa saja requirement sistem untuk MobileBuildMCP?
Membutuhkan macOS 14.5 atau versi terbaru dan Xcode 16.x atau versi terbaru, serta Node.js 18.x atau versi terbaru kecuali jika Anda menginstall via Homebrew.
Bisakah saya melakukan build untuk simulator dari command line dengan MobileBuildMCP?
Ya, CLI ini menyertakan perintah simulator build yang menerima scheme dan path proyek.
Apakah MobileBuildMCP mengirimkan telemetry?
Tool ini hanya menggunakan Sentry untuk telemetry error runtime internal, dan dokumentasinya menjelaskan cara untuk opt out.