XcodeBuildMCP

iOS ve macOS projeleri üzerinde çalışırken ajan kullanımı için araçlar sağlayan bir Model Context Protocol (MCP) sunucusu ve CLI.

GitHub

6.2k

Xcode Build MCP ile neler yapabilirsiniz?

Simülatör için bir uygulama derleyin — ajandanızdan, iOS veya macOS projenizi derlemek için bir şema ve proje yolu ile simulator build komutunu çalıştırmasını isteyin.
Belirli bir simülatörde testleri çalıştırın — önceden hazırlanmış test paketlerini yürütmek için bir test ürünleri yolu ve simülatör adı ile simulator test komutunu kullanın.
Test ürünlerini çalıştırmadan hazırlayın — taşınabilir .xctestproducts paketleri oluşturmak için --build-for-testing ve --test-products-path bayraklarıyla simulator build komutunu çağırın.
Bir AI istemcisi için MCP sunucusunu başlatın — kodlama ajanınızın MCP protokolü aracılığıyla tüm derleme ve test araçlarına erişebilmesi için mcp alt komutunu çalıştırın.
CLI'dan mevcut araçları listeleyin — geçerli ortamda hangi işlemlerin kullanılabilir olduğunu keşfetmek için tools komutunu kullanın.
Güncellemeleri kontrol edin ve uygulayın — CLI'yi yerinde güncellemek için upgrade --check veya upgrade --yes komutunu çalıştırın.

Dokümantasyon

iOS ve macOS projelerinde çalışırken ajan kullanımı için araçlar sağlayan bir Model Bağlam Protokolü (MCP) sunucusu ve CLI.

Kurulum

XcodeBuildMCP iki moda sahip tek bir paket olarak sunulur: doğrudan terminal kullanımı için bir CLI ve yapay zeka kodlama ajanları için bir MCP sunucusu. Her iki kurulum yöntemi de size her ikisini verir.

Seçenek A — Homebrew

brew tap getsentry/xcodebuildmcp
brew install xcodebuildmcp

Seçenek B — npm (Node.js 18+)

npm install -g xcodebuildmcp@latest

Her iki kurulumu da doğrulayın:

xcodebuildmcp --help

MCP istemcinizi bağlayın

Cursor, Claude Code, Codex için hazır yapılandırma parçacıkları resmi dokümantasyon sayfasında bulunabilir MCP Clients. Çoğu istemci, global bir kurulum olmadan npx -y xcodebuildmcp@latest mcp aracılığıyla MCP sunucusunu isteğe bağlı olarak da çalıştırabilir.

Gereksinimler

macOS 14.5 veya üzeri
Xcode 16.x veya üzeri
Node.js 18.x veya üzeri (Homebrew kurulumu için gerekli değildir)

Beceriler

XcodeBuildMCP artık iki isteğe bağlı ajan becerisi içerir:

MCP Becerisi: Ajana, MCP sunucusunun araçlarını nasıl kullanacağına dair talimatlar verir (MCP sunucusu kullanırken isteğe bağlıdır).
CLI Becerisi: Ajana, CLI'da nasıl gezineceğine dair talimatlar verir (CLI kullanırken önerilir).

Global bir ikili dosya ile kurmak için:

xcodebuildmcp init

Veya global kurulum olmadan doğrudan npx ile kurun:

npx -y xcodebuildmcp@latest init

Becerileri yükleme hakkında daha fazla bilgi için bkz. Agent Skills.

Notlar

XcodeBuildMCP, Swift Makroları kullanan projeleri derlerken hataları önlemek için xcodebuild'den makro doğrulamasını atlamasını ister.
Aygıt araçları, Xcode'da kod imzalamanın yapılandırılmış olmasını gerektirir. Bkz. Device Code Signing.

Gizlilik

XcodeBuildMCP, yalnızca dahili çalışma zamanı hata telemetrisi için Sentry kullanır. Ayrıntılar ve devre dışı bırakma talimatları için bkz. Privacy & Telemetry.

CLI

XcodeBuildMCP birleşik bir komut satırı arayüzü sağlar. mcp alt komutu MCP sunucusunu başlatırken, diğer tüm komutlar araçlara doğrudan terminal erişimi sağlar:

# Install globally
npm install -g xcodebuildmcp@latest

# Start the MCP server (for MCP clients)
xcodebuildmcp mcp

# List available tools
xcodebuildmcp tools

# Build for simulator
xcodebuildmcp simulator build --scheme MyApp --project-path ./MyApp.xcodeproj

# Prepare portable test products without running tests
xcodebuildmcp 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
xcodebuildmcp simulator test --test-products-path ./MyApp.xctestproducts --simulator-name "iPhone 17"

Güncellemeleri kontrol edin ve yerinde yükseltin:

xcodebuildmcp upgrade --check
xcodebuildmcp upgrade --yes

CLI, durum bilgisi olan işlemler (günlük yakalama, hata ayıklama vb.) için ihtiyaç duyulduğunda otomatik olarak başlayan çalışma alanı başına bir arka plan süreci kullanır. Tam belgeler için CLI guide sayfasına bakın.

Belgeler

Kurulum: https://xcodebuildmcp.com/docs/installation
Kurulum: https://xcodebuildmcp.com/docs/setup
MCP istemcileri: https://xcodebuildmcp.com/docs/clients
CLI kullanımı: https://xcodebuildmcp.com/docs/cli
Yapılandırma ve seçenekler: https://xcodebuildmcp.com/docs/configuration
Araç referansı: https://xcodebuildmcp.com/docs/tools
Sorun giderme: https://xcodebuildmcp.com/docs/troubleshooting
Gizlilik: https://xcodebuildmcp.com/docs/privacy
Beceriler: https://xcodebuildmcp.com/docs/skills
Katkıda bulunma: https://xcodebuildmcp.com/docs/contributing

Lisans

Bu proje MIT Lisansı altında lisanslanmıştır - ayrıntılar için LICENSE dosyasına bakın. Üçüncü taraf lisans bildirimleri için THIRD_PARTY_LICENSES dosyasına bakın. npm paketi atıfları için THIRD_PARTY_PACKAGE_LICENSES dosyasına bakın.