applescript-mcp MCP 服务器

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

特性

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

计划中的特性

• 📬 邮件（列出邮件、保存附件、摘要、发送）
• 🧭 Safari（在Safari中打开、保存页面内容、获取选中的页面/标签页）
• 💬 信息（发送、接收、列出）
• ✅ 提醒事项（创建、获取）
• 🗒️ 备忘录（创建、获取、列出）

先决条件

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

可用类别

日历

剪贴板

Finder

通知

系统

iTerm

开发

设置

# Install dependencies
npm install

# Build the server
npm run build

# Launch MCP Inspector
# See: 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 提供了一个用于测试和调试服务器的网页界面：

npm run inspector

日志

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

DEBUG=applescript-mcp* npm start

常见问题

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

资源

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

贡献

1. 分叉仓库
2. 创建一个功能分支
3. 提交你的更改
4. 推送到该分支
5. 创建一个拉取请求

许可证

MIT 许可证 - 查看 LICENSE 获取详情