AppleScript MCP 服务器项目教程

1. 项目介绍

本项目是基于Model Context Protocol（MCP）的服务器，允许用户通过运行AppleScript代码来与Mac系统进行交互。该MCP服务器设计简洁、直观，易于设置，核心代码不到100行，展现了其简洁而强大的特性。通过此服务器，用户可以控制Mac应用程序、访问数据、管理日程、搜索文件等。

2. 项目快速启动

环境准备

• Python环境（建议使用Homebrew安装）
• Node.js环境（建议使用Homebrew安装）

启动步骤

使用Node.js

1. 克隆项目到本地：

   git clone https://github.com/peakmojo/applescript-mcp.git
   cd applescript-mcp
   

2. 运行服务器：

   node server.js
   

使用Python

1. 安装uv库：

   brew install uv
   

2. 克隆项目到本地：

   git clone https://github.com/peakmojo/applescript-mcp.git
   cd applescript-mcp
   

3. 运行服务器：

   uv --directory /path/to/your/repo run src/applescript_mcp/server.py
   

3. 应用案例和最佳实践

• 创建提醒事项：通过发送请求到MCP服务器，可以创建一个提醒事项，例如："Create a reminder for me to call John tomorrow at 10am"。
• 添加日历事件：向MCP服务器发送指令，添加新的日历事件，如："Add a new meeting to my calendar for Friday from 2-3pm titled 'Team Review'"。
• 管理笔记：创建、编辑和显示笔记，例如："Create a new note titled 'Meeting Minutes' with today's date"。
• 搜索文件：查找特定时间段内的文件，如："Show me all files in my Downloads folder from the past week"。
• 系统监控：获取系统状态信息，如："What's my current battery percentage?"。

4. 典型生态项目

目前，该项目社区还不太活跃，仅有少数贡献者。但作为开源项目，它欢迎更多的开发者加入，共同扩展功能，优化性能。项目使用的语言主要是Python和JavaScript，两者的比例大约为60.7%和39.3%。在未来的发展中，可以预见会有更多围绕自动化控制和智能助手的项目加入到这个生态中。