applescript-mcp MCP 服务器

一个模型上下文协议服务器，使 LLM 应用程序能够通过 AppleScript 与 macOS 交互。 此服务器为 AI 应用程序提供了一个标准化的接口，用于控制系统功能、管理文件、处理通知等。

功能

• 🗓️ 日历管理（事件、提醒）
• 📋 剪贴板操作
• 🔍 Finder 集成
• 🔔 系统通知
• ⚙️ 系统控制（音量、黑暗模式、应用程序）
• 📟 iTerm 终端集成

计划功能

• 📬 邮件（列出电子邮件、保存附件、总结、发送）
• 🧭 Safari（在 Safari 中打开、保存页面内容、获取选定的页面/标签）
• 💬 消息（发送、获取、列表）
• ✅ 提醒事项（创建、获取）
• 🗒️ 笔记（创建、获取、列表）

前提条件

• macOS 10.15 或更高版本
• Node.js 18 或更高版本

可用类别

日历

命令	描述	参数
add	创建日历事件	title（标题）, startDate（开始日期）, endDate（结束日期）
list	列出今天的事件	无

剪贴板

命令	描述	参数
set_clipboard	复制到剪贴板	content（内容）
get_clipboard	获取剪贴板内容	无
clear_clipboard	清空剪贴板	无

Finder

命令	描述	参数
get_selected_files	获取选定的文件	无
search_files	搜索文件	query（查询）, location（位置）（可选）
quick_look	预览文件	path（路径）

通知

命令	描述	参数
send_notification	显示通知	title（标题）, message（消息）, sound（声音）（可选）
toggle_do_not_disturb	切换免打扰模式	无

系统

命令	描述	参数
volume	设置系统音量	level（级别）（0-100）
get_frontmost_app	获取活动应用程序	无
launch_app	打开应用程序	name（名称）
quit_app	关闭应用程序	name（名称）, force（强制）（可选）
toggle_dark_mode	切换黑暗模式	无

iTerm

命令	描述	参数
paste_clipboard	粘贴到 iTerm	无
run	执行命令	command（命令）, newWindow（新窗口）（可选）

开发

设置

# 安装依赖
npm install

# 构建服务器
npm run build

# 启动 MCP Inspector
# 参见: https://modelcontextprotocol.io/docs/tools/inspector
npx @modelcontextprotocol/inspector node path/to/server/index.js args...

添加新功能

1. 创建类别文件

创建 src/categories/newcategory.ts:

import { ScriptCategory } from "../types/index.js";

export const newCategory: ScriptCategory = {
  name: "category_name",
  description: "Category description",
  scripts: [
    // Scripts will go here
  ]
};

2. 添加脚本

{
  name: "script_name",
  description: "What the script does",
  schema: {
    type: "object",
    properties: {
      paramName: {
        type: "string",
        description: "Parameter description"
      }
    },
    required: ["paramName"]
  },
  script: (args) => `
    tell application "App"
      // AppleScript code using ${args.paramName}
    end tell
  `
}

3. 注册类别

更新 src/index.ts:

import { newCategory } from "./categories/newcategory.js";
// ...
server.addCategory(newCategory);

调试

使用 MCP Inspector

MCP Inspector 提供了一个 Web 界面，用于测试和调试您的服务器：

npm run inspector

日志记录

通过设置环境变量启用调试日志记录：

DEBUG=applescript-mcp* npm start

常见问题

• 权限错误: 检查系统偏好设置 > 安全性与隐私
• 脚本失败: 直接在 Script Editor.app 中测试脚本
• 通信问题: 检查 stdio 流是否被重定向

资源

• AppleScript 语言指南
• MCP 协议文档
• 问题跟踪器

贡献

1. Fork 仓库
2. 创建一个功能分支
3. 提交您的更改
4. 推送到分支
5. 创建一个 Pull Request

许可证

MIT 许可证 - 参见 LICENSE 了解详情