AppleScript MCP Server

AppleScript MCP Server làm gì?

AppleScript MCP Server là một máy chủ Model Context Protocol (MCP) được thiết kế để cung cấp cho các trợ lý AI và công cụ phát triển khả năng chạy mã AppleScript trên máy Mac. Với vai trò cầu nối, nó cho phép các tác nhân AI truy cập và kiểm soát các ứng dụng cũng như chức năng hệ thống trên Mac như tương tác với Notes, Calendar, Contacts, Messages và nhiều hơn nữa. Máy chủ hỗ trợ các tác vụ như tìm kiếm file qua Spotlight, đọc và ghi file, thực thi lệnh shell, thậm chí thực thi từ xa thông qua SSH. Thiết kế nhẹ, trực quan giúp việc tích hợp dễ dàng, tăng đáng kể tự động hóa, năng suất và quy trình phát triển cho người dùng Mac bằng cách cho phép truy cập lập trình đến nhiều tính năng của macOS.

Danh sách Prompt

Không có mẫu prompt tái sử dụng nào được tài liệu hóa trong repository. Chỉ có các prompt ví dụ dành cho người dùng cuối được cung cấp.

Danh sách Tài nguyên

Không có tài nguyên MCP rõ ràng nào được mô tả trong tài liệu hoặc mã nguồn hiện có.

Danh sách Công cụ

Không có danh sách công cụ chi tiết trong server.js hoặc tài liệu. Máy chủ cho phép thực thi bất kỳ AppleScript nào, nhưng các primitive cụ thể chưa được liệt kê.

Trường hợp sử dụng MCP Server này

• Tự động hóa ứng dụng Mac: Cho phép lập trình viên và tác nhân AI tự động hóa quy trình với Notes, Calendar, Contacts, Messages và các ứng dụng macOS khác bằng lệnh AppleScript.
• Quản lý file và hệ thống: Hỗ trợ tìm kiếm file bằng Spotlight hoặc Finder, đọc và ghi nội dung file, quản lý thư mục & tài liệu một cách lập trình.
• Truy xuất thông tin hệ thống: Dễ dàng tra cứu trạng thái hệ thống như phần trăm pin, dung lượng ổ đĩa, ứng dụng đang chạy, hữu ích cho cả người dùng và tác nhân tự động.
• Thực thi từ xa: Hỗ trợ thực thi AppleScript từ xa qua SSH, cho phép quản trị máy Mac từ máy khác hoặc môi trường container.
• Kiểm soát đa phương tiện & truyền thông: Cho phép điều khiển phát nhạc (ví dụ Apple Music) và tương tác với ứng dụng liên lạc để tự động hóa email, tin nhắn hoặc nhắc nhở.

Cách thiết lập

Windsurf

1. Đảm bảo Node.js đã được cài đặt trên hệ thống của bạn.
2. Mở file cấu hình Windsurf.
3. Thêm AppleScript MCP Server vào phần mcpServers bằng đoạn JSON dưới đây.
4. Lưu cấu hình và khởi động lại Windsurf.
5. Kiểm tra máy chủ đã chạy và sẵn sàng truy cập.

{
  "mcpServers": {
    "applescript_execute": {
      "command": "npx",
      "args": [
        "@peakmojo/applescript-mcp"
      ]
    }
  }
}

Claude

1. Đảm bảo Node.js đã được cài đặt.
2. Tìm và mở file cấu hình Claude.
3. Thêm MCP server như ví dụ bên dưới.
4. Lưu cấu hình và khởi động lại Claude.
5. Xác nhận MCP server đã khả dụng.

{
  "mcpServers": {
    "applescript_execute": {
      "command": "npx",
      "args": [
        "@peakmojo/applescript-mcp"
      ]
    }
  }
}

Cursor

1. Cài đặt Node.js trên hệ thống.
2. Mở file cấu hình của Cursor.
3. Thêm AppleScript MCP server vào phần mcpServers.
4. Lưu và khởi động lại Cursor.
5. Kiểm tra quá trình tích hợp đã thành công.

{
  "mcpServers": {
    "applescript_execute": {
      "command": "npx",
      "args": [
        "@peakmojo/applescript-mcp"
      ]
    }
  }
}

Cline

1. Kiểm tra Node.js đã được cài đặt.
2. Chỉnh sửa file cấu hình Cline.
3. Thêm cấu hình MCP server như ví dụ bên dưới.
4. Lưu thay đổi và khởi động lại Cline.
5. Kiểm tra máy chủ MCP đã hoạt động.

{
  "mcpServers": {
    "applescript_execute": {
      "command": "npx",
      "args": [
        "@peakmojo/applescript-mcp"
      ]
    }
  }
}

Bảo mật API Key và Thông tin đăng nhập

Với thực thi từ xa, các thông tin nhạy cảm như tên đăng nhập và mật khẩu SSH nên được cung cấp qua biến môi trường để tăng bảo mật. Ví dụ:

{
  "mcpServers": {
    "applescript_execute": {
      "command": "npx",
      "args": [
        "@peakmojo/applescript-mcp"
      ],
      "env": {
        "REMOTE_USER": "yourusername",
        "REMOTE_PASSWORD": "yourpassword"
      },
      "inputs": {
        "remoteHost": "host.docker.internal"
      }
    }
  }
}

Cách sử dụng MCP này trong flows

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à liên kết với tác nhân 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 hệ thống MCP, chèn thông tin máy chủ MCP theo định dạng JSON sau:

{
  "applescript_execute": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

Sau khi cấu hình, tác nhân AI sẽ sử dụng được MCP này như một công cụ với đầy đủ chức năng của nó. Hãy nhớ đổi “applescript_execute” thành tên thật của máy chủ MCP bạn và thay URL bằng URL máy chủ MCP của bạn.

Tổng quan

Dựa theo bảng trên, AppleScript MCP Server cung cấp tích hợp đơn giản nhưng có giới hạn. Điểm mạnh là kiểm soát trực tiếp Mac qua AppleScript. Tuy nhiên, nó còn thiếu tài liệu hóa về prompt, tài nguyên MCP rõ ràng và các primitive công cụ chi tiết. Sự hiện diện của giấy phép, mức phổ biến vừa phải và hướng dẫn thiết lập rõ ràng là những điểm cộng. Tổng thể, đây là công cụ rất hữu ích cho lĩnh vực chuyên biệt của nó, nhưng độ sâu tài liệu có thể cải thiện.

Điểm MCP