使用说明

项目简介

applescript-mcp MCP Server 是一个基于 Model Context Protocol (MCP) 构建的服务器，旨在使 LLM 应用能够通过 AppleScript 与 macOS 系统进行交互。它提供了一个标准化的接口，允许 AI 应用控制系统功能，管理文件，处理通知等等。

主要功能点

• 日历管理 (事件、提醒)
• 剪贴板操作
• Finder 文件管理器集成
• 系统通知
• 系统控制 (音量、深色模式、应用管理)
• iTerm 终端集成

安装步骤

1. 确保已安装 macOS 10.15 或更高版本，以及 Node.js 18 或更高版本。
2. 克隆仓库到本地：

   git clone https://github.com/MCP-Mirror/joshrutkowski_applescript-mcp.git
   

3. 进入仓库目录：

   cd applescript-mcp
   

4. 安装依赖：

   npm install
   

5. 构建服务器：

   npm run build
   

服务器配置

MCP 客户端需要配置以下 JSON 以连接到 applescript-mcp MCP 服务器。请注意，'command' 字段指定了启动服务器的命令，'args' 字段是传递给命令的参数。

{
  "serverName": "applescript-mcp",
  "command": "node",
  "args": [
    "path/to/applescript-mcp/dist/index.js"  // 请替换为实际的 index.js 文件路径
  ],
  "transport": "stdio"
}

注意:

• 请将 'path/to/applescript-mcp/dist/index.js' 替换为 'applescript-mcp' 项目构建后 'dist/index.js' 文件的实际绝对路径。你可以在项目根目录下运行 'npm run build' 后，在 'dist' 文件夹中找到 'index.js' 文件。
• 'transport' 字段设置为 'stdio' 表示使用标准输入输出流进行通信，这是该服务器默认的传输方式。

基本使用方法

1. 启动 MCP 服务器：根据上述配置，MCP 客户端会执行配置的命令来启动服务器。通常，在项目根目录下运行 'npm start' 也可以启动服务器 (package.json 中 scripts 配置了 'start' 命令 'npm run build && node dist/index.js').
2. 使用 MCP 客户端连接到服务器。客户端将能够发现服务器提供的工具 (Tools)，并调用这些工具来执行 macOS 系统操作。
3. 例如，客户端可以调用 'calendar_add' 工具来添加日历事件，或者调用 'finder_get_selected_files' 工具来获取 Finder 中选中的文件。
4. 详细的工具列表和参数信息，请参考仓库 README.md 文件中 "Available Categories" 部分的表格。