XcodeBuildMCP

Sebuah server dan CLI Model Context Protocol (MCP) yang menyediakan alat untuk penggunaan agen saat mengerjakan proyek iOS dan macOS.

GitHub

6.2k

Apa yang bisa Anda lakukan dengan Xcode Build MCP?

Buat aplikasi untuk simulator — minta agen untuk menjalankan simulator build dengan skema dan jalur proyek untuk mengompilasi proyek iOS atau macOS Anda.
Jalankan pengujian pada simulator tertentu — gunakan simulator test dengan jalur produk pengujian dan nama simulator untuk menjalankan bundel pengujian yang telah disiapkan sebelumnya.
Siapkan produk pengujian tanpa menjalankannya — panggil simulator build dengan --build-for-testing dan --test-products-path untuk menghasilkan bundel .xctestproducts yang portabel.
Mulai server MCP untuk klien AI — jalankan subperintah mcp sehingga agen pengkodean Anda dapat mengakses semua alat build dan pengujian melalui protokol MCP.
Daftarkan alat yang tersedia dari CLI — gunakan perintah tools untuk mengetahui operasi mana yang tersedia di lingkungan saat ini.
Periksa dan terapkan pembaruan — jalankan upgrade --check atau upgrade --yes untuk memperbarui CLI di tempat.

Dokumentasi

Server Model Context Protocol (MCP) dan CLI yang menyediakan alat untuk digunakan agen saat mengerjakan proyek iOS dan macOS.

Instalasi

XcodeBuildMCP hadir sebagai satu paket dengan dua mode: CLI untuk penggunaan terminal langsung dan server MCP untuk agen pengkodean AI. Metode instalasi mana pun memberi Anda keduanya.

Opsi A — Homebrew

brew tap getsentry/xcodebuildmcp
brew install xcodebuildmcp

Opsi B — npm (Node.js 18+)

npm install -g xcodebuildmcp@latest

Verifikasi instalasi mana pun:

xcodebuildmcp --help

Hubungkan klien MCP Anda

Cuplikan konfigurasi siap pakai untuk Cursor, Claude Code, Codex, dapat ditemukan di halaman dokumentasi resmi Klien MCP. Sebagian besar klien juga dapat menjalankan server MCP sesuai permintaan melalui npx -y xcodebuildmcp@latest mcp tanpa instalasi global.

Persyaratan

macOS 14.5 atau lebih baru
Xcode 16.x atau lebih baru
Node.js 18.x atau lebih baru (tidak diperlukan untuk instalasi Homebrew)

Keterampilan

XcodeBuildMCP kini menyertakan dua keterampilan agen opsional:

Keterampilan MCP: Mempersiapkan agen dengan instruksi tentang cara menggunakan alat server MCP (opsional saat menggunakan server MCP).
Keterampilan CLI: Mempersiapkan agen dengan instruksi tentang cara menavigasi CLI (disarankan saat menggunakan CLI).

Untuk menginstal dengan biner global:

xcodebuildmcp init

Atau instal langsung melalui npx tanpa instalasi global:

npx -y xcodebuildmcp@latest init

Untuk informasi lebih lanjut tentang menginstal keterampilan, lihat Keterampilan Agen.

Catatan

XcodeBuildMCP meminta xcodebuild untuk melewati validasi makro guna menghindari kesalahan saat membangun proyek yang menggunakan Makro Swift.
Alat perangkat memerlukan penandatanganan kode yang dikonfigurasi di Xcode. Lihat Penandatanganan Kode Perangkat.

Privasi

XcodeBuildMCP menggunakan Sentry hanya untuk telemetri kesalahan waktu proses internal. Untuk detail dan petunjuk penolakan, lihat Privasi & Telemetri.

CLI

XcodeBuildMCP menyediakan antarmuka baris perintah terpadu. Subperintah mcp memulai server MCP, sementara semua perintah lainnya menyediakan akses terminal langsung ke alat:

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

Periksa pembaruan dan tingkatkan di tempat:

xcodebuildmcp upgrade --check
xcodebuildmcp upgrade --yes

CLI menggunakan daemon per-ruang kerja untuk operasi stateful (penangkapan log, debugging, dll.) yang mulai otomatis saat diperlukan. Lihat panduan CLI untuk dokumentasi lengkap.

Dokumentasi

Instalasi: https://xcodebuildmcp.com/docs/installation
Pengaturan: https://xcodebuildmcp.com/docs/setup
Klien MCP: https://xcodebuildmcp.com/docs/clients
Penggunaan CLI: https://xcodebuildmcp.com/docs/cli
Konfigurasi dan opsi: https://xcodebuildmcp.com/docs/configuration
Referensi alat: https://xcodebuildmcp.com/docs/tools
Pemecahan masalah: https://xcodebuildmcp.com/docs/troubleshooting
Privasi: https://xcodebuildmcp.com/docs/privacy
Keterampilan: https://xcodebuildmcp.com/docs/skills
Berkontribusi: https://xcodebuildmcp.com/docs/contributing

Lisensi

Proyek ini dilisensikan di bawah Lisensi MIT - lihat berkas LICENSE untuk detailnya. Untuk pemberitahuan lisensi pihak ketiga, lihat berkas THIRD_PARTY_LICENSES untuk detailnya. Untuk atribusi paket npm, lihat berkas THIRD_PARTY_PACKAGE_LICENSES untuk detailnya.