项目简介

这是一个基于 Model Context Protocol (MCP) 的服务器实现，专为 macOS 用户设计。它允许支持 MCP 协议的 LLM 客户端（如 AI 助手）直接通过 AppleScript 与你的 Mac 进行交互，执行各种自动化任务和系统控制。

主要功能点

执行 AppleScript: 接收并运行 LLM 提供的 AppleScript 代码。
控制 Mac 应用和系统: 通过 AppleScript 操纵 Finder、Notes、Calendar、Mail、Safari 等 macOS 应用，管理文件、设置、数据等。
MCP 标准接口: 提供符合 MCP 协议的工具接口，方便 LLM 调用。

安装步骤

克隆仓库:

git clone https://github.com/Hassanali4/applescript-mcp.git
cd applescript-mcp

下载并运行: 访问项目的 Releases 页面，下载适用于你系统的最新版本可执行文件。直接运行该文件即可启动服务器。

（或者，如果你是开发者或想从源码运行 Node.js 版本）：

安装依赖:
```
npm install
```
启动服务器:
```
npm start
```

服务器配置

MCP 客户端需要配置连接信息才能与此服务器通信。由于该服务器使用 Stdio 传输协议，你需要配置启动服务器进程的命令。以下是一个示例配置，具体命令可能取决于你的安装方式（例如，直接运行下载的可执行文件或通过 npm 启动）。

// 这是一个配置示例，请根据实际情况调整 "command" 字段
{
  "name": "AppleScript MCP",             // 服务器名称，用于客户端识别
  "command": "/path/to/your/executable", // 启动 AppleScript MCP 服务器进程的命令或可执行文件路径
  "args": [],                            // 启动命令的参数列表，通常为空或包含日志级别等
  "transport": "stdio"                   // 传输协议，此处使用标准输入输出 (Stdio)
}

请将 '"/path/to/your/executable"' 替换为你下载的可执行文件路径，或者如果通过 npm 启动，可能是 'npm' 且 'args' 为 '["start"]' 并在项目目录下执行。

基本使用方法

配置好 MCP 客户端并连接到 AppleScript MCP 服务器后，你的 LLM 就可以调用服务器提供的工具了。主要的工具是 'applescript_execute'。

LLM 可以通过调用 'applescript_execute' 工具，并提供 'code_snippet' 参数来执行 AppleScript 代码。例如，你可以让 LLM 编写并执行 AppleScript 代码来创建一个新的备忘录、查找文件或控制音乐播放。

例如，如果你想让 LLM 在桌面上创建一个名为 "MyNewFolder" 的文件夹，你可以指示 LLM 调用 'applescript_execute' 工具，并将参数 'code_snippet' 设置为 ''tell application "Finder" to make new folder at desktop with properties {name:"MyNewFolder"}''。服务器将执行此脚本并将结果（或错误信息）返回给 LLM。

工具参数：

'code_snippet' (字符串, 必需): 要执行的 AppleScript 代码片段。
'timeout' (整数, 可选): 命令执行的超时时间（秒），默认为 60 秒。

关键词

项目简介

主要功能点

安装步骤

服务器配置

基本使用方法

信息