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.5k

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

Build for simulator — Yêu cầu AI của bạn biên dịch một ứng dụng iOS hoặc macOS cho một trình mô phỏng cụ thể bằng cách sử dụng scheme và đường dẫn dự án đã đặt tên.
Prepare test products — Cho phép AI của bạn tạo các gói kiểm thử di động mà không cần chạy kiểm thử, nhắm mục tiêu đến một trình mô phỏng đã chọn.
Run prepared tests — Hướng dẫn AI của bạn thực thi các sản phẩm kiểm thử đã được xây dựng trước đó trên một trình mô phỏng được chỉ định.
List available tools — Yêu cầu AI của bạn hiển thị toàn bộ tập hợp các lệnh CLI và khả năng của máy chủ MCP mà nó có thể gọi.
Check for updates — Yêu cầu AI của bạn xác minh phiên bản đã cài đặt và nâng cấp công cụ tại chỗ khi cần thiết.

Tài liệu

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

Cài đặt

MobileBuildMCP đượ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 qua terminal và máy chủ MCP cho các tác nhân lập trình AI. Cả hai phương pháp cài đặt đều cung cấp cho bạn cả hai chế độ.

Tùy chọn A — Homebrew

brew tap getsentry/xcodebuildmcp
brew install mobilebuildmcp

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

npm install -g mobilebuildmcp@latest

Xác minh một trong hai cách cài đặt:

mobilebuildmcp --help

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

Các đoạn cấu hình sẵn sàng 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 mobilebuildmcp@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 bắt buộc khi cài đặt qua Homebrew)

Kỹ năng

MobileBuildMCP 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 một tệp nhị phân toàn cục:

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

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

Ghi chú

MobileBuildMCP 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 cấu hình ký mã trong Xcode. Xem Device Code Signing.

Quyền riêng tư

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

CLI

MobileBuildMCP cung cấp giao diện dòng lệnh thống nhất. Lệnh con 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 terminal trực tiếp vào các công cụ:

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

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

mobilebuildmcp upgrade --check
mobilebuildmcp upgrade --yes

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

Tài liệu

Cài đặt: https://github.com/getsentry/xcodebuildmcp.com/blob/main/app/docs/_content/installation.mdx
Thiết lập: https://github.com/getsentry/xcodebuildmcp.com/blob/main/app/docs/_content/setup.mdx
Máy khách MCP: https://github.com/getsentry/xcodebuildmcp.com/blob/main/app/docs/_content/clients.mdx
Sử dụng CLI: https://github.com/getsentry/xcodebuildmcp.com/blob/main/app/docs/_content/cli.mdx
Cấu hình và tùy chọn: https://github.com/getsentry/xcodebuildmcp.com/blob/main/app/docs/_content/configuration.mdx
Tham chiếu công cụ: https://github.com/getsentry/xcodebuildmcp.com/blob/main/app/docs/_content/tools.mdx
Khắc phục sự cố: https://github.com/getsentry/xcodebuildmcp.com/blob/main/app/docs/_content/troubleshooting.mdx
Quyền riêng tư: https://github.com/getsentry/xcodebuildmcp.com/blob/main/app/docs/_content/privacy.mdx
Kỹ năng: https://github.com/getsentry/xcodebuildmcp.com/blob/main/app/docs/_content/skills.mdx
Đóng góp: https://github.com/getsentry/xcodebuildmcp.com/blob/main/app/docs/_content/contributing.mdx

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. Để biết thông báo cấp phép của bên thứ ba, hãy xem tệp THIRD_PARTY_LICENSES để biết chi tiết. Để biết ghi nhận gói npm, hãy xem tệp THIRD_PARTY_PACKAGE_LICENSES để biết chi tiết.