applescript-mcp MCP Server

基本能力

产品定位

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 或更高版本

安装教程

# 安装依赖
npm install

# 构建服务器
npm run build

# 启动 MCP Inspector
npx @modelcontextprotocol/inspector node path/to/server/index.js args...

调试方式

# 使用 MCP Inspector 调试
npm run inspector

# 启用调试日志
DEBUG=applescript-mcp* npm start

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。