Bir AI istemcisinin komut satırı veya MCP araçları üzerinden Xcode projelerini ve iOS simülatörlerini oluşturmasına, test etmesine ve yönetmesine olanak tanır.
Ayrıca bilinen adı getsentry/XcodeBuildMCP, @mseep/xcodebuildmcp
- Yıldızlar
- 6.569
- Araçlar
- —
- İndirmeler, 30 gün
- —
- En son sürüm
- 2.7.0
- Son commit
- 13 Kas 2026
- Lisans
- MIT
XcodeBuildMCP MCP nedir?
XcodeBuildMCP bir MCP sunucusudur. Bir AI istemcisinin komut satırı veya MCP araçları üzerinden Xcode projelerini ve iOS simülatörlerini oluşturmasına, test etmesine ve yönetmesine olanak tanır.
Özet, projenin README dosyasından oluşturuldu
XcodeBuildMCP MCP nasıl yüklenir
Biçimler 10 Kas 2026 tarihinde doğrulandıXcodeBuildMCP MCP'yi Claude Code içine yükleyin
$ claude mcp add xcodebuildmcp -- npx -y xcodebuildmcpXcodeBuildMCP MCP'yi Cursor içine yükleyin
~/.cursor/mcp.json
{
"mcpServers": {
"xcodebuildmcp": {
"command": "npx",
"args": [
"-y",
"xcodebuildmcp"
]
}
}
}XcodeBuildMCP MCP'yi VS Code içine yükleyin
.vscode/mcp.json
{
"servers": {
"xcodebuildmcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"xcodebuildmcp"
]
}
}
}XcodeBuildMCP MCP'yi Claude Desktop içine yükleyin
claude_desktop_config.json
{
"mcpServers": {
"xcodebuildmcp": {
"command": "npx",
"args": [
"-y",
"xcodebuildmcp"
]
}
}
}XcodeBuildMCP MCP'yi Codex içine yükleyin
~/.codex/config.toml
[mcp_servers.xcodebuildmcp] command = "npx" args = ["-y", "xcodebuildmcp"]
XcodeBuildMCP MCP'yi Gemini CLI içine yükleyin
~/.gemini/settings.json
{
"mcpServers": {
"xcodebuildmcp": {
"command": "npx",
"args": [
"-y",
"xcodebuildmcp"
]
}
}
}Yapılandırma
INCREMENTAL_BUILDS_ENABLEDEnable experimental xcodemake incremental builds (true/false or 1/0).
XCODEBUILDMCP_DEBUGEnable verbose debug logging from the server.
XCODEBUILDMCP_ENABLED_WORKFLOWSComma-separated list of workflows to load at startup (e.g., 'simulator,device,project-discovery').
XCODEBUILDMCP_SENTRY_DISABLEDDisable Sentry error reporting (preferred flag).
| Ad | Açıklama | Sunucu |
|---|---|---|
| INCREMENTAL_BUILDS_ENABLED | Enable experimental xcodemake incremental builds (true/false or 1/0). | |
| XCODEBUILDMCP_DEBUG | Enable verbose debug logging from the server. | |
| XCODEBUILDMCP_ENABLED_WORKFLOWS | Comma-separated list of workflows to load at startup (e.g., 'simulator,device,project-discovery'). | |
| XCODEBUILDMCP_SENTRY_DISABLED | Disable Sentry error reporting (preferred flag). |
Otomatik kontroller
Çalıştırıldı 11 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şilebilirGeçti
- Açık kaynak lisansı (OSI)Geçti
- Son bir yıl içinde commit veya sürüm mevcutGeçti
- Paket adı popüler bir pakete yakın değilGeçti
- Uzak uç nokta HTTPS kullanıyorKontrol edilmedi
- Yıkıcı araçlar etiketlenmişKontrol edilmedi
- Modele yönelik gizli talimat yokGeçti
- Pakette ve bağımlılıklarında kritik uyarı yokGeçti
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.
XcodeBuildMCP MCP soruları
XcodeBuildMCP MCP'yi Claude Code'a nasıl eklerim?
Terminalinizde claude mcp add xcodebuildmcp -- npx -y xcodebuildmcp komutunu çalıştırın. Her projede kullanılabilir olması için --scope user ekleyin.
XcodeBuildMCP 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.
XcodeBuildMCP ne işe yarar?
iOS ve macOS projeleri üzerinde çalışırken, simülatörler için derleme yapma ve hazırlanmış test ürünlerini çalıştırma dahil olmak üzere agent kullanımı için araçlar sağlar.
XcodeBuildMCP nasıl kurulur?
Homebrew ile brew tap getsentry/xcodebuildmcp ve brew install mobilebuildmcp komutlarını kullanarak veya npm ile npm install -g mobilebuildmcp@latest komutuyla kurabilirsiniz.
XcodeBuildMCP için gereksinimler nelerdir?
macOS 14.5 veya üzeri, Xcode 16.x veya üzeri ve Node.js 18.x veya üzeri gereklidir (Homebrew kurulumu için Node gerekmez).
XcodeBuildMCP'yi global kurulum yapmadan çalıştırabilir miyim?
Evet, çoğu MCP istemcisi sunucuyu npx -y mobilebuildmcp@latest mcp komutuyla talep üzerine çalıştırabilir.