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.5k

XcodeBuildMCP MCP ile neler yapabilirsiniz?

  • Simülatör için derle — Yapay zekândan, adlandırılmış bir şema ve proje yolu kullanarak belirli bir simülatör için bir iOS veya macOS uygulaması derlemesini isteyin.
  • Test ürünlerini hazırla — Yapay zekândan, testleri çalıştırmadan seçilen bir simülatörü hedefleyen taşınabilir test paketleri oluşturmasını sağlayın.
  • Hazırlanan testleri çalıştır — Yapay zekâna, daha önce derlenmiş test ürünlerini belirtilen bir simülatörde çalıştırmasını talimat verin.
  • Mevcut araçları listele — Yapay zekândan, çağırabileceği CLI komutlarının ve MCP sunucu yeteneklerinin tamamını göstermesini isteyin.
  • Güncellemeleri kontrol et — Yapay zekândan, yüklü sürümü doğrulamasını ve gerektiğinde aracı yerinde yükseltmesini isteyin.

Dokümantasyon

A Model Context Protocol (MCP) sunucusu ve CLI'si; iOS ve macOS projeleri üzerinde çalışırken aracı kullanımı için araçlar sağlar.

CI npm version License: MIT Node.js Xcode 16 macOS MCP Ask DeepWiki AgentAudit Security pkg.pr.new

Kurulum

MobileBuildMCP, iki modlu tek bir paket olarak sunulur: doğrudan terminal kullanımı için bir CLI ve yapay zeka kodlama aracıları için bir MCP sunucusu. Her iki kurulum yöntemi de size her ikisini birden sağlar.

Seçenek A — Homebrew

brew tap getsentry/xcodebuildmcp
brew install mobilebuildmcp

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

npm install -g mobilebuildmcp@latest

Her iki kurulumu da doğrulayın:

mobilebuildmcp --help

MCP istemcinizi bağlayın

Cursor, Claude Code ve Codex için hazır yapılandırma parçacıkları resmi dokümantasyon sayfası MCP Clients bölümünde bulunabilir. Çoğu istemci, MCP sunucusunu genel bir kurulum olmadan npx -y mobilebuildmcp@latest mcp aracılığıyla 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

MobileBuildMCP artık iki isteğe bağlı aracı becerisi içerir:

  • MCP Becerisi: Aracıyı, MCP sunucusunun araçlarını nasıl kullanacağına dair talimatlarla hazırlar (MCP sunucusunu kullanırken isteğe bağlı).

  • CLI Becerisi: Aracıyı, CLI'da nasıl gezinileceğine dair talimatlarla hazırlar (CLI kullanırken önerilir).

Genel bir ikili dosya ile kurmak için:

mobilebuildmcp init

Veya genel bir kurulum olmadan doğrudan npx ile kurun:

npx -y mobilebuildmcp@latest init

Becerilerin kurulumu hakkında daha fazla bilgi için Agent Skills bölümüne bakın.

Notlar

  • MobileBuildMCP, Swift Makroları kullanan projeleri derlerken hataları önlemek için xcodebuild'den makro doğrulamasını atlamasını ister.
  • Cihaz araçları, Xcode'da kod imzalamanın yapılandırılmış olmasını gerektirir. Device Code Signing bölümüne bakın.

Gizlilik

MobileBuildMCP, Sentry'yi yalnızca dahili çalışma zamanı hata telemetrisi için kullanır. Ayrıntılar ve devre dışı bırakma talimatları için Privacy & Telemetry bölümüne bakın.

CLI

MobileBuildMCP 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 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"

Güncellemeleri kontrol edin ve yerinde yükseltin:

mobilebuildmcp upgrade --check
mobilebuildmcp upgrade --yes

CLI, durum bilgisi gerektiren işlemler (log yakalama, hata ayıklama vb.) için gerektiğinde otomatik başlayan çalışma alanı başına bir arka plan süreci kullanır. Tam dokümantasyon için CLI guide bölümüne bakın.

Dokümantasyon

Lisans

Bu proje MIT Lisansı ile 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 paket atıfları için THIRD_PARTY_PACKAGE_LICENSES dosyasına bakın.