基本能力
产品定位
applescript-mcp 是一个连接 LLM 应用程序与 macOS 系统的桥梁，通过标准化的接口实现系统控制和自动化操作。
核心功能
- 日历管理：创建事件、列出今日事件
- 剪贴板操作：设置、获取和清空剪贴板内容
- Finder 集成：获取选中的文件、搜索文件、快速预览文件
- 系统通知：发送通知、切换勿扰模式
- 系统控制：调节音量、获取当前应用、启动/关闭应用、切换暗黑模式
- iTerm 终端集成：粘贴剪贴板内容、执行命令
适用场景
- 自动化脚本：通过 LLM 生成 AppleScript 来自动化日常任务
- 系统管理：远程或通过 AI 助手控制系统设置
- 开发辅助：在开发过程中快速执行系统级操作
工具列表
- MCP Inspector：提供 Web 界面用于测试和调试服务器
- Script Editor.app：直接测试 AppleScript
常见问题解答
- 权限错误：检查系统偏好设置中的安全与隐私
- 脚本失败：直接在 Script Editor.app 中测试脚本
- 通信问题：确保 stdio 流没有被重定向
使用教程
使用依赖
- macOS 10.15 或更高版本
- Node.js 18 或更高版本
安装教程
```bash
安装依赖
npm install
构建服务器
npm run build
启动 MCP Inspector
npx @modelcontextprotocol/inspector node path/to/server/index.js args...
```
调试方式
```bash
使用 MCP Inspector 调试
npm run inspector
启用调试日志
DEBUG=applescript-mcp* npm start
```
