macos-automator-mcp 的安装和配置教程

1. 项目基础介绍

macos-automator-mcp 是一个开源项目，它提供了一个 Model Context Protocol (MCP) 服务器，名为 macos_automator，能够允许在 macOS 上执行 AppleScript 和 JavaScript for Automation (JXA) 脚本。该项目支持预定义脚本库，可以通过 ID 访问，同时支持内联脚本、脚本文件和参数传递。

该项目主要使用的编程语言是 TypeScript。

2. 项目使用的关键技术和框架

• TypeScript：项目的主体语言，提供了类型系统和编译时类型检查，增强了代码的可靠性和可维护性。
• Node.js：运行环境，提供了 JavaScript 的运行时，使得可以在非浏览器环境下执行 JavaScript 代码。
• AppleScript 和 JXA：macOS 系统的自动化脚本语言，可以用来控制 macOS 的应用程序和系统功能。

3. 项目安装和配置的准备工作

在开始安装前，请确保您的系统满足以下要求：

• 操作系统：macOS
• Node.js：版本 18.0.0 或更高（可以在 Node.js 官网 下载安装）

此外，您需要在系统中设置一些关键权限，具体步骤如下：

• 自动化权限：前往 “系统偏好设置” > “隐私与安全性” > “自动化”，确保运行服务器的应用程序（如终端）有权限控制其他应用程序（Finder、Safari、Mail 等）。
• 辅助功能权限：前往 “系统偏好设置” > “隐私与安全性” > “辅助功能”，添加运行服务器的应用程序到列表中，并确保其复选框被勾选。

详细安装步骤

1. 克隆项目仓库：在终端中执行以下命令，将项目克隆到本地：

   git clone https://github.com/steipete/macos-automator-mcp.git
   

2. 进入项目目录：使用 cd 命令进入项目文件夹：

   cd macos-automator-mcp
   

3. 安装依赖：在项目目录中执行以下命令安装依赖：

   npm install
   

4. 配置 MCP 客户端：更新您的 MCP 客户端的配置文件（如 mcp.json），使其指向克隆仓库中 start.sh 脚本的绝对路径。例如：

   {
     "mcpServers": {
       "macos_automator_local": {
         "command": "/absolute/path/to/your/cloned/macos-automator-mcp/start.sh",
         "env": {
           "LOG_LEVEL": "DEBUG"
         }
       }
     }
   }
   

   请确保将 "/absolute/path/to/your/cloned/macos-automator-mcp/start.sh" 替换为您的系统中 start.sh 脚本的正确路径。

5. 运行服务器：配置完成后，可以通过以下命令启动服务器：

   ./start.sh
   

按照以上步骤操作，您应该能够成功安装和配置 macos-automator-mcp 项目，并开始使用它来执行 AppleScript 和 JXA 脚本。