XcodeBuildMCP

เซิร์ฟเวอร์ Model Context Protocol (MCP) และ CLI ที่ให้เครื่องมือสำหรับเอเจนต์เมื่อทำงานกับโปรเจกต์ iOS และ macOS

การติดตั้ง

MobileBuildMCP มาพร้อมเป็นแพ็กเกจเดียวที่มีสองโหมด: CLI สำหรับใช้ในเทอร์มินัลโดยตรง และ MCP server สำหรับเอเจนต์เขียนโค้ด AI ไม่ว่าคุณจะติดตั้งด้วยวิธีใดก็จะได้ทั้งสองโหมด

ตัวเลือก A — Homebrew

brew tap getsentry/xcodebuildmcp
brew install mobilebuildmcp

ตัวเลือก B — npm (Node.js 18+)

npm install -g mobilebuildmcp@latest

ตรวจสอบการติดตั้งด้วยวิธีใดวิธีหนึ่ง:

mobilebuildmcp --help

เชื่อมต่อ MCP client ของคุณ

ตัวอย่างการกำหนดค่าสำหรับ Cursor, Claude Code, Codex สามารถดูได้ในหน้าเอกสารอย่างเป็นทางการ MCP Clients ไคลเอนต์ส่วนใหญ่ยังสามารถรัน MCP server ตามความต้องการผ่าน npx -y mobilebuildmcp@latest mcp โดยไม่ต้องติดตั้งแบบ global

ข้อกำหนด

• macOS 14.5 หรือใหม่กว่า
• Xcode 16.x หรือใหม่กว่า
• Node.js 18.x หรือใหม่กว่า (ไม่จำเป็นสำหรับการติดตั้งผ่าน Homebrew)

ทักษะ (Skills)

MobileBuildMCP ตอนนี้มีทักษะเอเจนต์เสริมสองแบบ:

• MCP Skill: เตรียมความพร้อมให้เอเจนต์ด้วยคำแนะนำเกี่ยวกับวิธีใช้เครื่องมือของ MCP server (ไม่จำเป็นเมื่อใช้ MCP server)

• CLI Skill: เตรียมความพร้อมให้เอเจนต์ด้วยคำแนะนำเกี่ยวกับวิธีใช้งาน CLI (แนะนำเมื่อใช้ CLI)

หากต้องการติดตั้งด้วยไบนารีแบบ global:

mobilebuildmcp init

หรือติดตั้งโดยตรงผ่าน npx โดยไม่ต้องติดตั้งแบบ global:

npx -y mobilebuildmcp@latest init

สำหรับข้อมูลเพิ่มเติมเกี่ยวกับการติดตั้งทักษะ ดู Agent Skills

หมายเหตุ

• MobileBuildMCP ขอให้ xcodebuild ข้ามการตรวจสอบ macro เพื่อหลีกเลี่ยงข้อผิดพลาดเมื่อสร้างโปรเจกต์ที่ใช้ Swift Macros
• เครื่องมือสำหรับอุปกรณ์ต้องมีการกำหนดค่า code signing ใน Xcode ดู Device Code Signing

ความเป็นส่วนตัว

MobileBuildMCP ใช้ Sentry สำหรับการเก็บข้อมูล telemetry ข้อผิดพลาดภายในขณะรันไทม์เท่านั้น สำหรับรายละเอียดและวิธีเลือกไม่ใช้ ดู Privacy & Telemetry

CLI

MobileBuildMCP มีอินเทอร์เฟซบรรทัดคำสั่งแบบรวม คำสั่งย่อย mcp ใช้เริ่ม MCP server ในขณะที่คำสั่งอื่น ๆ ให้การเข้าถึงเครื่องมือโดยตรงผ่านเทอร์มินัล:

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

ตรวจสอบอัปเดตและอัปเกรดในที่:

mobilebuildmcp upgrade --check
mobilebuildmcp upgrade --yes

CLI ใช้ daemon ต่อเวิร์กสเปซสำหรับการทำงานที่ต้องมีสถานะ (การจับบันทึก, การดีบัก ฯลฯ) ซึ่งจะเริ่มอัตโนมัติเมื่อจำเป็น ดู CLI guide สำหรับเอกสารฉบับเต็ม

เอกสาร

• การติดตั้ง: https://github.com/getsentry/xcodebuildmcp.com/blob/main/app/docs/_content/installation.mdx
• การตั้งค่า: 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: https://github.com/getsentry/xcodebuildmcp.com/blob/main/app/docs/_content/cli.mdx
• การกำหนดค่าและตัวเลือก: https://github.com/getsentry/xcodebuildmcp.com/blob/main/app/docs/_content/configuration.mdx
• เอกสารอ้างอิงเครื่องมือ: https://github.com/getsentry/xcodebuildmcp.com/blob/main/app/docs/_content/tools.mdx
• การแก้ไขปัญหา: https://github.com/getsentry/xcodebuildmcp.com/blob/main/app/docs/_content/troubleshooting.mdx
• ความเป็นส่วนตัว: https://github.com/getsentry/xcodebuildmcp.com/blob/main/app/docs/_content/privacy.mdx
• ทักษะ: https://github.com/getsentry/xcodebuildmcp.com/blob/main/app/docs/_content/skills.mdx
• การมีส่วนร่วม: https://github.com/getsentry/xcodebuildmcp.com/blob/main/app/docs/_content/contributing.mdx

สัญญาอนุญาต

โปรเจกต์นี้อยู่ภายใต้สัญญาอนุญาต MIT License - ดูไฟล์ LICENSE สำหรับรายละเอียด สำหรับประกาศสัญญาอนุญาตของบุคคลที่สาม ดูไฟล์ THIRD_PARTY_LICENSES สำหรับรายละเอียด สำหรับการระบุแหล่งที่มาของแพ็กเกจ npm ดูไฟล์ THIRD_PARTY_PACKAGE_LICENSES สำหรับรายละเอียด