一个macOS AppleScript MCP服务器
概览
一款模型上下文协议服务器，使LLM应用程序能够通过AppleScript与macOS交互。该服务器为AI应用提供了标准化界面，用于控制系统功能、管理文件、处理通知等。 - 🗓️ 日历管理（事件、提醒）- 📋 剪贴板操作 - 🔍 Finder集成 - 🔔 系统通知 - ⚙️ 系统控制（音量、暗色模式、应用）- 📟 iTerm 终端集成 - 📬 邮件（创建新邮件、列表邮件、接收邮件）- 🔄 快捷键自动化 - 💬 消息（列表聊天、接收消息、搜索消息、发送消息）- 🗒️ 笔记（创建格式化笔记、列表笔记、搜索笔记）- 📄 页面（创建文档） - 🧭 Safari（在Safari中打开，保存页面内容，获取选中的页面/标签页）- ✅ 提醒（创建，获取） - macOS 10.15及更高版本- Node.js 18及更高版本 注意：发送通知需要你在系统设置>通知>脚本编辑器中启用通知。
概述（AI 翻译）
一个模型上下文协议服务器，使LLM应用程序能够通过AppleScript与macOS交互。 该服务器为 AI 应用提供了标准化界面，用于控制系统功能、管理文件、处理通知等。
特色
- 🗓️ 日历管理（事件、提醒）
- 📋 剪贴板操作
- 🔍 Finder 集成
- 🔔 系统通知
- ⚙️ 系统控制（音量、暗黑模式、应用程序）
- 📟 iTerm终端积分
- 📬 邮件（创建新邮箱，列出邮件列表，接收邮件）
- 🔄 快捷键自动化
- 💬 消息（列表聊天、接收消息、搜索消息、发送消息）
- 🗒️ 笔记（创建格式化笔记、列表笔记、搜索笔记）
- 📄 页面（创建文档）
计划中内容
- 🧭 Safari（在Safari中打开，保存页面内容，获取选中的页面/标签页）
- ✅ 提醒（创建，获取）
先修条件
- macOS 10.15 或更高版本
- Node.js 18岁及以上
可用类别
日历
| 指令 | 描述 | 参数 |
|---|---|---|
add |
创建日历事件 | title， startDate， endDate， calendar（可选） |
list |
今天的活动列表 | 无 |
本页由 AI 翻译，技术细节请以原文为准。
README
以下为原文 README 节选，完整内容请查看原文。
applescript-mcp MCP Server
A Model Context Protocol server that enables LLM applications to interact with macOS through AppleScript. This server provides a standardized interface for AI applications to control system functions, manage files, handle notifications, and more.
Features
- 🗓️ Calendar management (events, reminders)
- 📋 Clipboard operations
- 🔍 Finder integration
- 🔔 System notifications
- ⚙️ System controls (volume, dark mode, apps)
- 📟 iTerm terminal integration
- 📬 Mail (create new email, list emails, get email)
- 🔄 Shortcuts automation
- 💬 Messages (list chats, get messages, search messages, send a message)
- 🗒️ Notes (create formatted notes, list notes, search notes)
- 📄 Pages (create documents)
Planned Features
- 🧭 Safari (open in Safari, save page content, get selected page/tab)
- ✅ Reminders (create, get)
Prerequisites
- macOS 10.15 or later
- Node.js 18 or later
Available Categories
Calendar
| Command | Description | Parameters |
|---|---|---|
add |
Create calendar event | title, startDate, endDate, calendar (optional) |
list |
List today’s events | None |
Examples
// Create a new calendar event
Create a calendar event titled "Team Meeting" starting tomorrow at 2pm for 1 hour
// List today's events
What events do I have scheduled for today?
Clipboard
| Command | Description | Parameters |
|---|---|---|
set_clipboard |
Copy to clipboard | content |
get_clipboard |
Get clipboard contents | None |
clear_clipboard |
Clear clipboard | None |
Examples
// Copy text to clipboard
Copy "Remember to buy groceries" to my clipboard
// Get clipboard contents
What's currently in my clipboard?
// Clear clipboard
Clear my clipboard
Finder
| Command | Description | Parameters |
|---|---|---|
get_selected_files |
Get selected files | None |
search_files |
Search for files | query, location (optional) |
quick_look |
Preview file | path |
Examples
// Get selected files in Finder
What files do I currently have selected in Finder?
// Search for files
Find all PDF files in my Documents folder
// Preview a file安装
npx @modelcontextprotocol/inspector node path/to/server/index.js args...配置
{
"mcpServers": {
"applescript-mcp-server": {
"command": "node",
"args": ["/path/to/applescript-mcp/dist/index.js"]
}
}
}