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

2025-05-18 06:32:45作者：虞亚竹Luna

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 等）。
辅助功能权限：前往 “系统偏好设置” > “隐私与安全性” > “辅助功能”，添加运行服务器的应用程序到列表中，并确保其复选框被勾选。

详细安装步骤

克隆项目仓库：在终端中执行以下命令，将项目克隆到本地：
```
git clone https://github.com/steipete/macos-automator-mcp.git
```
进入项目目录：使用 cd 命令进入项目文件夹：
```
cd macos-automator-mcp
```
安装依赖：在项目目录中执行以下命令安装依赖：
```
npm install
```
配置 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 脚本的正确路径。
运行服务器：配置完成后，可以通过以下命令启动服务器：
```
./start.sh
```