XcodeBuildMCP

Một máy chủ Giao thức Ngữ cảnh Mô hình (MCP) và CLI cung cấp các công cụ cho tác nhân sử dụng khi làm việc trên các dự án iOS và macOS.

GitHub
6.2k

Bạn có thể làm gì với Xcode Build MCP?

  • Xây dựng ứng dụng cho trình mô phỏng — yêu cầu tác nhân chạy simulator build với scheme và đường dẫn dự án để biên dịch dự án iOS hoặc macOS của bạn.
  • Chạy kiểm thử trên một trình mô phỏng cụ thể — sử dụng simulator test với đường dẫn sản phẩm kiểm thử và tên trình mô phỏng để thực thi các gói kiểm thử đã chuẩn bị trước.
  • Chuẩn bị sản phẩm kiểm thử mà không chạy chúng — gọi simulator build với --build-for-testing và --test-products-path để tạo ra các gói .xctestproducts di động.
  • Khởi động máy chủ MCP cho một ứng dụng khách AI — chạy lệnh con mcp để tác nhân lập trình của bạn có thể truy cập tất cả các công cụ xây dựng và kiểm thử thông qua giao thức MCP.
  • Liệt kê các công cụ có sẵn từ CLI — sử dụng lệnh tools để khám phá những thao tác nào có sẵn trong môi trường hiện tại.
  • Kiểm tra và áp dụng các bản cập nhật — chạy upgrade --check hoặc upgrade --yes để cập nhật CLI tại chỗ.

Tài liệu

XcodeBuild MCP

Một máy chủ Giao thức Ngữ cảnh Mô hình (MCP) và CLI cung cấp các công cụ cho tác nhân sử dụng khi làm việc trên các dự án iOS và macOS.

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

Cài đặt

XcodeBuildMCP được phân phối dưới dạng một gói duy nhất với hai chế độ: CLI để sử dụng trực tiếp trên terminal và máy chủ MCP cho các tác nhân lập trình AI. Cả hai phương thức cài đặt đều cung cấp cho bạn cả hai.

Tùy chọn A — Homebrew

brew tap getsentry/xcodebuildmcp
brew install xcodebuildmcp

Tùy chọn B — npm (Node.js 18+)

npm install -g xcodebuildmcp@latest

Xác minh cài đặt:

xcodebuildmcp --help

Kết nối máy khách MCP của bạn

Các đoạn cấu hình có sẵn cho Cursor, Claude Code, Codex có thể được tìm thấy trong trang tài liệu chính thức MCP Clients. Hầu hết các máy khách cũng có thể chạy máy chủ MCP theo yêu cầu thông qua npx -y xcodebuildmcp@latest mcp mà không cần cài đặt toàn cục.

Yêu cầu

  • macOS 14.5 trở lên
  • Xcode 16.x trở lên
  • Node.js 18.x trở lên (không yêu cầu đối với cài đặt Homebrew)

Kỹ năng

XcodeBuildMCP hiện bao gồm hai kỹ năng tác nhân tùy chọn:

  • Kỹ năng MCP: Chuẩn bị cho tác nhân các hướng dẫn về cách sử dụng các công cụ của máy chủ MCP (tùy chọn khi sử dụng máy chủ MCP).

  • Kỹ năng CLI: Chuẩn bị cho tác nhân các hướng dẫn về cách điều hướng CLI (khuyến nghị khi sử dụng CLI).

Để cài đặt với tệp nhị phân toàn cục:

xcodebuildmcp init

Hoặc cài đặt trực tiếp qua npx mà không cần cài đặt toàn cục:

npx -y xcodebuildmcp@latest init

Để biết thêm thông tin về cài đặt kỹ năng, xem Agent Skills.

Ghi chú

  • XcodeBuildMCP yêu cầu xcodebuild bỏ qua xác thực macro để tránh lỗi khi xây dựng các dự án sử dụng Swift Macros.
  • Các công cụ thiết bị yêu cầu ký mã được cấu hình trong Xcode. Xem Device Code Signing.

Quyền riêng tư

XcodeBuildMCP chỉ sử dụng Sentry cho phép đo từ xa lỗi thời gian chạy nội bộ. Để biết chi tiết và hướng dẫn từ chối, xem Privacy & Telemetry.

CLI

XcodeBuildMCP cung cấp giao diện dòng lệnh thống nhất. Lệnh phụ mcp khởi động máy chủ MCP, trong khi tất cả các lệnh khác cung cấp quyền truy cập trực tiếp vào các công cụ qua terminal:

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

Kiểm tra cập nhật và nâng cấp tại chỗ:

xcodebuildmcp upgrade --check
xcodebuildmcp upgrade --yes

CLI sử dụng một daemon cho mỗi không gian làm việc cho các hoạt động có trạng thái (ghi nhật ký, gỡ lỗi, v.v.) tự động khởi động khi cần. Xem CLI guide để có tài liệu đầy đủ.

Tài liệu

Giấy phép

Dự án này được cấp phép theo Giấy phép MIT - xem tệp LICENSE để biết chi tiết. Đối với các thông báo cấp phép của bên thứ ba, xem tệp THIRD_PARTY_LICENSES để biết chi tiết. Đối với các ghi nhận gói npm, xem tệp THIRD_PARTY_PACKAGE_LICENSES để biết chi tiết.