macOS Automator MCP 服务器项目启动与配置教程

1. 项目的目录结构及介绍

macOS Automator MCP 服务器项目是一个基于 Node.js 的 Model Context Protocol (MCP) 服务器，用于在 macOS 上执行 AppleScript 和 JavaScript for Automation (JXA) 脚本。以下是项目的目录结构及各部分的功能介绍：

• src/: 源代码目录，包含了服务器的主要逻辑和功能实现。
• tests/: 测试目录，存放了项目的单元测试和集成测试。
• assets/: 资源目录，可能包含项目所需的各种资源文件。
• docs/: 文档目录，存放了项目的文档和教程。
• knowledge_base/: 知识库目录，包含了预定义的自动化脚本。
• scripts/: 脚本目录，包含了启动服务器和其他辅助脚本。
• .gitignore: 指定 Git 忽略的文件和目录。
• package.json: Node.js 项目配置文件，定义了项目的依赖和脚本。
• tsconfig.json: TypeScript 配置文件，定义了 TypeScript 编译器的选项。
• README.md: 项目说明文件，包含了项目的简介和使用说明。

2. 项目的启动文件介绍

项目的启动文件是 start.sh 脚本，位于项目根目录下。这个脚本用于启动 MCP 服务器。以下是 start.sh 脚本的主要内容：

#!/bin/bash

# 确定是否需要编译 TypeScript 代码
if [ ! -f dist/server.js ]; then
    echo "Compiling TypeScript..."
    tsx
fi

# 启动服务器
node dist/server.js

该脚本首先检查是否存在编译后的 server.js 文件，如果不存在，则使用 tsx 命令编译 TypeScript 代码。然后，使用 node 命令启动编译后的服务器。

3. 项目的配置文件介绍

项目的配置主要通过 mcp.json 文件进行。mcp.json 文件用于配置 MCP 客户端的 MCP 服务器。以下是一个示例配置：

{
  "mcpServers": {
    "macos_automator": {
      "command": "npx",
      "args": ["-y", "@steipete/macos-automator-mcp@latest"]
    }
  }
}

在这个配置文件中，mcpServers 对象下的 "macos_automator" 键定义了如何启动 MCP 服务器。command 和 args 字段指定了使用 npx 命令来运行最新版本的 macos-automator-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" 为你在系统上的实际路径。此外，你可以通过 env 字段设置环境变量，如 LOG_LEVEL 以调整日志输出级别。