XcodeBuildMCP

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

GitHub
6.5k

Apa yang bisa Anda lakukan dengan XcodeBuildMCP MCP?

  • Build for simulator — Minta AI Anda untuk mengompilasi aplikasi iOS atau macOS untuk simulator tertentu menggunakan skema dan jalur proyek yang ditentukan.
  • Prepare test products — Minta AI Anda menghasilkan bundel uji portabel tanpa menjalankan pengujian, dengan menargetkan simulator yang dipilih.
  • Run prepared tests — Instruksikan AI Anda untuk menjalankan produk uji yang telah dibuat sebelumnya pada simulator yang ditentukan.
  • List available tools — Minta AI Anda untuk menampilkan seluruh rangkaian perintah CLI dan kemampuan server MCP yang dapat dipanggilnya.
  • Check for updates — Minta AI Anda untuk memverifikasi versi yang terinstal dan meningkatkan alat tersebut di tempat jika diperlukan.

Dokumentasi

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

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

Instalasi

MobileBuildMCP dikirim 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 mobilebuildmcp

Opsi B — npm (Node.js 18+)

npm install -g mobilebuildmcp@latest

Verifikasi salah satu instalasi:

mobilebuildmcp --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 mobilebuildmcp@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

MobileBuildMCP kini menyertakan dua keterampilan agen opsional:

  • Keterampilan MCP: Menyiapkan agen dengan instruksi tentang cara menggunakan alat server MCP (opsional saat menggunakan server MCP).

  • Keterampilan CLI: Menyiapkan agen dengan instruksi tentang cara menavigasi CLI (disarankan saat menggunakan CLI).

Untuk menginstal dengan biner global:

mobilebuildmcp init

Atau instal langsung melalui npx tanpa instalasi global:

npx -y mobilebuildmcp@latest init

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

Catatan

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

Privasi

MobileBuildMCP menggunakan Sentry untuk telemetri kesalahan runtime internal saja. Untuk detail dan petunjuk menonaktifkan, lihat Privasi & Telemetri.

CLI

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

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

Periksa pembaruan dan tingkatkan di tempat:

mobilebuildmcp upgrade --check
mobilebuildmcp upgrade --yes

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

Dokumentasi

Lisensi

Proyek ini dilisensikan di bawah Lisensi MIT - lihat file LISENSI untuk detailnya. Untuk pemberitahuan lisensi pihak ketiga, lihat file LISENSI_PIHAK_KETIGA untuk detailnya. Untuk atribusi paket npm, lihat file LISENSI_PAKET_PIHAK_KETIGA untuk detailnya.