“Xcode” MCP Server làm gì?

Xcode MCP (Model Context Protocol) Server là một công cụ chuyên biệt giúp kết nối các trợ lý AI với môi trường phát triển Xcode. Bằng cách cung cấp một loạt các thao tác liên quan đến Xcode thông qua giao thức chuẩn hóa, nó cho phép các tác tử AI quản lý dự án Xcode, tự động hóa thao tác tệp, điều khiển giả lập iOS và tương tác với các phụ thuộc, công cụ build khác nhau. Sự tích hợp sâu này giúp tối ưu quy trình phát triển, cho phép các tác vụ như build, kiểm thử, phân tích mã, quản lý phụ thuộc (CocoaPods và Swift Package Manager) và điều khiển simulator được thực hiện tự động hoặc thông qua trợ lý thông minh. Server này đặc biệt hữu ích để tự động hóa các tác vụ lặp đi lặp lại, nâng cao chất lượng mã nguồn và tăng tốc phát triển dự án iOS/macOS bằng cách giúp các tính năng mạnh mẽ của Xcode dễ dàng truy cập qua ngôn ngữ tự nhiên hoặc giao diện AI.

Danh sách Prompt

Không có prompt template nào được đề cập trong các file repository hoặc tài liệu.

Danh sách Resource

Không có resource rõ ràng (theo định nghĩa MCP) được liệt kê trong tài liệu hoặc repository.

Danh sách Công cụ

• Công cụ Quản lý Dự án

  • Đặt dự án đang hoạt động và lấy thông tin dự án.
  • Tạo dự án Xcode mới từ template (vd: iOS, macOS).
  • Thêm file vào dự án với chỉ định target/group.
  • Phân tích tài liệu workspace và liệt kê scheme.

• Thao tác Tệp

  • Đọc và ghi tệp (hỗ trợ encoding).
  • Xử lý tệp nhị phân qua base64.
  • Tìm kiếm văn bản bằng pattern/regex.
  • Kiểm tra sự tồn tại và metadata của tệp.
  • Tự động tạo thư mục.

• Build & Kiểm thử

  • Build dự án với tùy chọn riêng.
  • Chạy kiểm thử và báo cáo lỗi.
  • Phân tích mã tìm vấn đề.
  • Dọn dẹp thư mục build.
  • Đóng gói dự án để phân phối.

• Tích hợp CocoaPods

  • Khởi tạo, cài đặt, cập nhật, quản lý pod.
  • Thêm/xóa phụ thuộc pod.
  • Chạy lệnh pod tùy ý.

• Swift Package Manager

  • Quản lý package và phụ thuộc Swift.
  • Cập nhật/giải quyết package.
  • Sinh tài liệu.
  • Build và kiểm thử package.

• Công cụ Giả lập iOS

  • Liệt kê, khởi động, tắt giả lập.
  • Cài đặt và mở ứng dụng.
  • Chụp ảnh màn hình/quay video.
  • Quản lý cài đặt giả lập.

• Tiện ích Xcode

  • Chạy lệnh Xcode qua xcrun.
  • Biên dịch asset catalog.
  • Sinh bộ icon app.
  • Theo dõi hiệu năng app.
  • Xuất/xác thực archive lên App Store.
  • Chuyển đổi giữa các phiên bản Xcode.

Các trường hợp sử dụng MCP Server này

• Tự động hóa Khởi tạo Dự án
  Tác tử AI có thể nhanh chóng tạo mới và cấu hình dự án Xcode, thiết lập công cụ quản lý phụ thuộc như CocoaPods hoặc Swift Package Manager, chuẩn bị cấu trúc thư mục, giúp giảm đáng kể công sức thủ công khi bắt đầu dự án.

• Tích hợp & Kiểm thử liên tục (CI/CD)
  Tự động hóa quá trình build, kiểm thử và phân tích cho dự án iOS/macOS. Quy trình dựa trên AI có thể kích hoạt build, chạy kiểm thử, báo cáo lỗi hoặc vấn đề mã nguồn, giúp triển khai pipeline CI/CD mạnh mẽ ngay từ giao diện chat hoặc script.

• Quản lý và kiểm thử Giả lập
  Điều khiển giả lập iOS tự động cho kiểm thử UI, cài đặt app, chụp ảnh hoặc quay video, tăng độ phủ và độ tin cậy khi kiểm thử ứng dụng di động.

• Quản lý phụ thuộc
  Đơn giản hóa việc thêm, xóa và cập nhật thư viện bên thứ ba với CocoaPods hoặc Swift Package Manager, đảm bảo dự án luôn mới và tương thích với ít thao tác thủ công hơn.

• Quản lý tài sản & build
  Tự động hóa biên dịch tài sản, sinh icon, quản lý artifact build (bao gồm đóng gói và xuất bản lên App Store), tăng hiệu quả và giảm thiểu rủi ro sai sót thủ công.

Cách thiết lập

Windsurf

1. Đảm bảo đã cài macOS, Xcode (14.0+), Node.js (16+) và npm.
2. Tải hoặc clone repository xcode-mcp-server.
3. Chạy script setup:

   chmod +x setup.sh
   ./setup.sh
   

4. Sửa file cấu hình Windsurf để thêm MCP server:

   {
     "mcpServers": {
       "xcode-mcp": {
         "command": "npx",
         "args": ["@xcode/mcp-server@latest"]
       }
     }
   }
   

5. Lưu cấu hình và khởi động lại Windsurf. Kiểm tra bằng cách xác nhận công cụ Xcode MCP đã xuất hiện.

Claude

1. Cài đặt các phần mềm cần thiết (macOS, Xcode, Node.js, npm).
2. Clone repo và chạy script setup như trên.
3. Tìm file cấu hình MCP của Claude.
4. Thêm Xcode MCP server:

   {
     "mcpServers": {
       "xcode-mcp": {
         "command": "npx",
         "args": ["@xcode/mcp-server@latest"]
       }
     }
   }
   

5. Lưu và khởi động lại Claude. Xác nhận setup qua danh sách công cụ.

Cursor

1. Đảm bảo đã cài xong tất cả phụ thuộc.
2. Clone repository và chạy script setup.
3. Mở file cấu hình MCP của Cursor.
4. Thêm đoạn sau vào phần mcpServers:

   {
     "mcpServers": {
       "xcode-mcp": {
         "command": "npx",
         "args": ["@xcode/mcp-server@latest"]
       }
     }
   }
   

5. Lưu và khởi động lại Cursor, sau đó xác nhận server đã hoạt động.

Cline

1. Thiết lập các thành phần cần thiết và chạy script cài đặt.
2. Mở file cấu hình MCP server của Cline.
3. Thêm mục Xcode MCP server:

   {
     "mcpServers": {
       "xcode-mcp": {
         "command": "npx",
         "args": ["@xcode/mcp-server@latest"]
       }
     }
   }
   

4. Lưu thay đổi và khởi động lại Cline.
5. Xác nhận Xcode MCP server đã hoạt động trong Cline.

Bảo mật API Key bằng biến môi trường

• Đặt dữ liệu nhạy cảm (API key, token) trong file .env.
• Ví dụ sử dụng .env:

  XCODE_MCP_API_KEY=your_api_key_here
  

• Tham chiếu biến môi trường trong cấu hình:

  {
    "mcpServers": {
      "xcode-mcp": {
        "command": "npx",
        "args": ["@xcode/mcp-server@latest"],
        "env": {
          "XCODE_MCP_API_KEY": "${XCODE_MCP_API_KEY}"
        },
        "inputs": {
          "projectBaseDir": "/Users/yourname/Projects"
        }
      }
    }
  }
  

Cách dùng MCP này trong luồng

Sử dụng MCP trong FlowHunt

Để tích hợp MCP server vào quy trình FlowHunt, hãy thêm thành phần MCP vào flow và kết nối với tác tử AI của bạn:

Nhấp vào thành phần MCP để mở bảng cấu hình. Trong phần cấu hình MCP hệ thống, chèn thông tin MCP server của bạn theo định dạng JSON sau:

{
  "xcode-mcp": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

Khi đã cấu hình xong, tác tử AI sẽ sử dụng MCP này như một công cụ với đầy đủ chức năng. Nhớ đổi “MCP-name” thành tên thực tế của MCP server của bạn (vd: “xcode-mcp”) và thay URL bằng địa chỉ MCP server của bạn.

Tổng quan

Dựa theo thông tin trên, Xcode MCP Server rất mạnh về tự động hóa Xcode, nhưng thiếu tài liệu về prompt template, resource MCP rõ ràng và tính năng sampling/roots. Điểm mạnh là bộ công cụ dự án/build đầy đủ và hướng dẫn setup rõ ràng.

Đánh giá MCP

Tổng kết, tôi chấm MCP server này 7 trên 10 điểm.
Nó cung cấp tích hợp Xcode toàn diện và công cụ tự động hóa tốt, có tài liệu setup đầy đủ và license rõ ràng. Tuy nhiên, thiếu thông tin về prompt template, resource MCP rõ ràng, roots và sampling support, là những yếu tố quan trọng để tuân thủ MCP đầy đủ và xây dựng quy trình nâng cao.