Bir AI agent'ın MCP araçları veya bir CLI aracılığıyla iOS ve macOS Xcode projelerini oluşturmasına, test etmesine ve yönetmesine olanak tanır.
Ayrıca bilinen adı getsentry/MobileBuildMCP
- Yıldızlar
- 6.573
- Araçlar
- 24
- İndirmeler, 30 gün
- —
- En son sürüm
- —
- Son commit
- 13 Kas 2026
- Lisans
- MIT
MobileBuildMCP MCP nedir?
Bir AI agent'ın MCP araçları veya bir CLI aracılığıyla iOS ve macOS Xcode projelerini oluşturmasına, test etmesine ve yönetmesine olanak tanır. 24 araç sunar; örneğin session_show_defaults, session_use_defaults_profile, session_set_defaults.
Özet, projenin README dosyasından oluşturuldu
MobileBuildMCP MCP sunucusu hakkında
MobileBuildMCP, iOS ve macOS geliştirme iş akışlarının bir AI agent aracılığıyla yönetilmesini sağlar. AI kodlama asistanları ile Xcode arasında bir köprü kurarak agent'ların projeleri doğrudan oluşturmasına, test etmesine ve yönetmesine olanak tanır. Geliştiriciler, Claude Code veya Cursor gibi istemciler için özel bir MCP server olarak kullanabilir veya birleşik bir komut satırı arayüzü üzerinden etkileşime girebilirler.
Kurulum Homebrew veya npm üzerinden yapılabilir; sistem macOS 14.5 veya üzeri ile Xcode 16.x gerektirir. Araç, Swift Macros kullanan projelerin hata almamasını sağlamak için build sırasında macro doğrulamasını atlayan özel bir mantık içerir. CLI kullananlar için, log yakalama ve debugging gibi stateful görevleri her workspace için ayrı bir daemon yönetir. Server agentic kullanım için tasarlanmış olsa da, manuel proje yönetimi için standart bir terminal aracı olarak da işlev görür.
Neler yapabilirsiniz
- 1Simulatorlar için projeler oluşturunBir AI agent'tan, bir simulator hedefi için belirli bir Xcode scheme'ini derlemesini isteyin.
- 2Test ürünleri hazırlayınAgent'a, testleri hemen çalıştırmadan taşınabilir test ürünleri oluşturması talimatını verin.
- 3Otomatik testleri çalıştırınAI'ın, daha önce hazırlanmış test ürünlerini belirli bir simulator ismi üzerinde çalıştırmasını sağlayın.
- 4Yazılım güncellemelerini yönetinAracı kontrol etmek ve sürüm yükseltmelerini uygulamak için CLI'yı kullanın.
Projenin README dosyasından alınmıştır. Her kullanım durumu, oradaki bir alıntı ile kontrol edilir.
MobileBuildMCP MCP nasıl yüklenir
Biçimler 10 Kas 2026 tarihinde doğrulandıCursor'a ekleGoose'a ekleMobileBuildMCP MCP'yi Claude Code içine yükleyin
$ claude mcp add mobilebuildmcp -- npx -y mobilebuildmcp mcpMobileBuildMCP MCP'yi Cursor içine yükleyin
~/.cursor/mcp.json
{
"mcpServers": {
"mobilebuildmcp": {
"command": "npx",
"args": [
"-y",
"mobilebuildmcp",
"mcp"
]
}
}
}MobileBuildMCP MCP'yi VS Code içine yükleyin
.vscode/mcp.json
{
"servers": {
"mobilebuildmcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"mobilebuildmcp",
"mcp"
]
}
}
}MobileBuildMCP MCP'yi VS Code CLI içine yükleyin
$ code --add-mcp '{"name":"mobilebuildmcp","type":"stdio","command":"npx","args":["-y","mobilebuildmcp","mcp"]}'MobileBuildMCP MCP'yi Claude Desktop içine yükleyin
claude_desktop_config.json
{
"mcpServers": {
"mobilebuildmcp": {
"command": "npx",
"args": [
"-y",
"mobilebuildmcp",
"mcp"
]
}
}
}MobileBuildMCP MCP'yi Codex içine yükleyin
$ codex mcp add mobilebuildmcp -- npx -y mobilebuildmcp mcpMobileBuildMCP MCP'yi Codex config.toml içine yükleyin
~/.codex/config.toml
[mcp_servers.mobilebuildmcp] command = "npx" args = ["-y", "mobilebuildmcp", "mcp"]
MobileBuildMCP MCP'yi Gemini CLI içine yükleyin
$ gemini mcp add -s user mobilebuildmcp npx -- -y mobilebuildmcp mcpMobileBuildMCP MCP'yi Gemini settings.json içine yükleyin
~/.gemini/settings.json
{
"mcpServers": {
"mobilebuildmcp": {
"command": "npx",
"args": [
"-y",
"mobilebuildmcp",
"mcp"
]
}
}
}HostedMCP tarafından 16 Kas 2026 tarihinde başlatıldı
Bu komutu mobilebuildmcp 2.7.1 için ağsız ve anahtarsız, yalıtılmış bir konteynerde çalıştırdık. Yanıt verdi ve 24 araç listeledi.
MobileBuildMCP MCP araçları 24
Sunucudan tools/list ile okundusession_show_defaultsSalt okunurShow current active defaults. Required before your first build/run/test call in a session — do not assume defaults are configured.
session_use_defaults_profileEylemSwitch the active session defaults profile.
session_set_defaultsEylemSet session defaults for the active profile, or for a specified profile and make it active.
session_clear_defaultsEylemClear session defaults for the active profile or a specified profile.
list_simsSalt okunurList iOS simulators.
boot_simEylemBoot iOS simulator for manual/non-build flows. Not required before simulator build-and-run (build_run_sim).
open_simSalt okunurOpen the simulator frontend for visibility and manual workflows. Not required before simulator build-and-run (build_run_sim).
build_simEylemBuild for iOS sim (compile-only, no launch).
build_run_simEylemBuild, 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_simEylemTest on iOS sim.
get_sim_app_pathSalt okunurGet sim built app path.
install_app_simEylemInstall 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. | Salt okunur |
| session_use_defaults_profile | Switch the active session defaults profile. | Eylem |
| session_set_defaults | Set session defaults for the active profile, or for a specified profile and make it active. | Eylem |
| session_clear_defaults | Clear session defaults for the active profile or a specified profile. | Eylem |
| list_sims | List iOS simulators. | Salt okunur |
| boot_sim | Boot iOS simulator for manual/non-build flows. Not required before simulator build-and-run (build_run_sim). | Eylem |
| open_sim | Open the simulator frontend for visibility and manual workflows. Not required before simulator build-and-run (build_run_sim). | Salt okunur |
| build_sim | Build for iOS sim (compile-only, no launch). | Eylem |
| 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. | Eylem |
| test_sim | Test on iOS sim. | Eylem |
| get_sim_app_path | Get sim built app path. | Salt okunur |
| install_app_sim | Install app on sim. | Eylem |
24 aracın tümünü gösterDaha az araç göster
launch_app_simEylemLaunch app on simulator. Runtime logs are captured automatically and the log file path is included in the response.
stop_app_simEylemStop sim app.
record_sim_videoEylemRecord sim video.
cleanEylemClean build products.
discover_projsSalt okunurScans a directory (defaults to workspace root) to find Xcode project (.xcodeproj) and workspace (.xcworkspace) files. Use when project/workspace path is unknown.
list_schemesSalt okunurList Xcode schemes.
show_build_settingsSalt okunurShow build settings.
get_app_bundle_idSalt okunurExtract bundle id from .app.
screenshotSalt okunurCapture screenshot.
snapshot_uiSalt okunurCapture 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_reportSalt okunurShow per-target code coverage from an xcresult bundle.
get_file_coverageSalt okunurShow 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. | Eylem |
| stop_app_sim | Stop sim app. | Eylem |
| record_sim_video | Record sim video. | Eylem |
| clean | Clean build products. | Eylem |
| 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. | Salt okunur |
| list_schemes | List Xcode schemes. | Salt okunur |
| show_build_settings | Show build settings. | Salt okunur |
| get_app_bundle_id | Extract bundle id from .app. | Salt okunur |
| screenshot | Capture screenshot. | Salt okunur |
| 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. | Salt okunur |
| get_coverage_report | Show per-target code coverage from an xcresult bundle. | Salt okunur |
| get_file_coverage | Show function-level coverage and uncovered line ranges for a specific file. | Salt okunur |
Otomatik kontroller
Çalıştırıldı 16 Kas 2026Tam rapor →Otomatik kontrollerimizden geçti. Bu bir güvenlik denetimi değildir: kodu okuyun ve sunucuya ihtiyaç duyduğu en dar erişimi verin. Kontroller nasıl çalışır
- Kaynak deposu bağlantılı ve erişilebilirgetsentry/mobilebuildmcp is public and reachablegithub.com/getsentry/mobilebuildmcp ↗Geçti
- Paket, bu depoyu kaynağı olarak gösteriyormobilebuildmcp names getsentry/mobilebuildmcp as sourcenpmjs.com/package/mobilebuildmcp ↗Geçti
- Derleme kökeni (Sigstore onayı)Sigstore attestation for mobilebuildmcpnpmjs.com/package/mobilebuildmcp/v/2.7.1#provenance ↗Geçti
- Açık kaynak lisansı (OSI)MITspdx.org/licenses/MIT.html ↗Geçti
- Son bir yıl içinde commit veya sürüm mevcutLast commit or release 2026-11-13github.com/getsentry/mobilebuildmcp ↗Geçti
- OpenSSF ScorecardKontrol edilmedi
- Paket adı popüler bir pakete yakın değilNo popular package one edit away from mobilebuildmcpGeçti
- Pakette veya bağımlılıklarında kritik uyarı yokKontrol edilmedi
- Modele yönelik gizli talimat yok24 tool descriptions and the README read; no override phrases, credential paths or hidden charactersGeçti
- Yıkıcı araçlar etiketlenmişNo tool named like delete, drop or execGeçti
- Uzak uç nokta MCP el sıkışmasına yanıt veriyorKontrol edilmedi
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 soruları
MobileBuildMCP MCP'yi Claude Code'a nasıl eklerim?
Terminalinizde claude mcp add mobilebuildmcp -- npx -y mobilebuildmcp mcp komutunu çalıştırın. Her projede kullanılabilir olması için --scope user ekleyin.
MobileBuildMCP MCP'yi Cursor'a nasıl eklerim?
~/.cursor/mcp.json dosyasını açın ve yukarıdaki yükleme bölümünde gösterilen Cursor yapılandırmasını kullanarak sunucuyu mcpServers altına ekleyin.
MobileBuildMCP MCP hangi araçları sunar?
24 araç sunar; bunlar arasında session_show_defaults, session_use_defaults_profile, session_set_defaults, session_clear_defaults, list_sims yer alır.
MobileBuildMCP, iOS ve macOS projeleri için ne yapar?
Agent'ların iOS ve macOS için simulator build'leri ve test ürünleri dahil olmak üzere Xcode projelerini oluşturmasına, test etmesine ve yönetmesine olanak tanıyan MCP araçları ve CLI komutları sağlar.
MobileBuildMCP nasıl kurulur?
Homebrew üzerinden getsentry tap ile veya npm üzerinden global olarak mobilebuildmcp@latest komutuyla kurabilirsiniz; her iki yöntem de size CLI ve MCP server sağlar.
MobileBuildMCP için sistem gereksinimleri nelerdir?
Homebrew ile kurmadıysanız, macOS 14.5 veya üzeri, Xcode 16.x veya üzeri ve Node.js 18.x veya üzeri gereklidir.
MobileBuildMCP ile komut satırından bir simulator için build alabilir miyim?
Evet, CLI, bir scheme ve proje yolu alan bir simulator build komutu içerir.
MobileBuildMCP telemetry gönderir mi?
Sentry'yi yalnızca dahili runtime hata telemetry'si için kullanır ve dokümantasyon nasıl devre dışı bırakılacağını açıklar.