XcodeBuildMCP

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

การติดตั้ง

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

ตัวเลือก A — Homebrew

brew tap getsentry/xcodebuildmcp
brew install xcodebuildmcp

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

npm install -g xcodebuildmcp@latest

ตรวจสอบการติดตั้งด้วยวิธีใดก็ตาม:

xcodebuildmcp --help

เชื่อมต่อไคลเอนต์ MCP ของคุณ

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

ความต้องการ

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

สกิล

XcodeBuildMCP มีสกิลเสริมสำหรับเอเจนต์สองตัว:

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

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

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

xcodebuildmcp init

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

npx -y xcodebuildmcp@latest init

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

หมายเหตุ

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

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

XcodeBuildMCP ใช้ Sentry สำหรับการตรวจวัดข้อผิดพลาดรันไทม์ภายในเท่านั้น สำหรับรายละเอียดและคำแนะนำในการยกเลิก ดูที่ Privacy & Telemetry

CLI

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

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

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

xcodebuildmcp upgrade --check
xcodebuildmcp upgrade --yes

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

เอกสาร

• การติดตั้ง: https://xcodebuildmcp.com/docs/installation
• การตั้งค่า: https://xcodebuildmcp.com/docs/setup
• ไคลเอนต์ MCP: https://xcodebuildmcp.com/docs/clients
• การใช้งาน CLI: https://xcodebuildmcp.com/docs/cli
• การกำหนดค่าและตัวเลือก: https://xcodebuildmcp.com/docs/configuration
• อ้างอิงเครื่องมือ: https://xcodebuildmcp.com/docs/tools
• การแก้ไขปัญหา: https://xcodebuildmcp.com/docs/troubleshooting
• ความเป็นส่วนตัว: https://xcodebuildmcp.com/docs/privacy
• สกิล: https://xcodebuildmcp.com/docs/skills
• การมีส่วนร่วม: https://xcodebuildmcp.com/docs/contributing

ใบอนุญาต

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