项目简介
mcp-server-apple-reminders 是一个基于 Model Context Protocol (MCP) 的服务器实现,它允许大型语言模型(LLM)通过标准的MCP协议与macOS上的“提醒事项”应用进行交互。借助此服务器,LLM可以帮助用户通过自然语言指令创建、查询和管理提醒事项,从而提升个人助理和自动化任务处理能力。
主要功能点
- 创建提醒事项: 允许LLM创建新的提醒事项,可以指定标题、截止日期、所属列表和备注信息。
- 列出提醒事项: 支持LLM查询并列出所有提醒事项,或者特定提醒事项列表中的事项。
- 列出提醒事项列表: 使LLM能够获取用户所有提醒事项列表的名称。
- 自然语言日期解析: 服务器能够解析自然语言描述的日期和时间,并将其转换为提醒事项应用可识别的格式。
安装步骤
- 安装 Bun: 确保你的macOS系统上已安装 Bun JavaScript 运行时环境。如果未安装,请按照 Bun 官网的指引进行安装。
- 下载仓库代码: 将 'mcp-server-apple-reminders' 仓库克隆到本地。
- 安装依赖: 在仓库根目录下,打开终端并运行以下命令安装项目依赖:
bun install
服务器配置
要将此MCP服务器与MCP客户端(如 Claude 桌面应用)连接,你需要配置客户端的 MCP 服务器设置。配置信息通常是一个 JSON 对象,你需要提供服务器的启动命令和参数。
以下是 'apple-reminders' 服务器的配置信息示例,请将其添加到你的 MCP 客户端配置文件中:
{ "mcpServers": { "apple-reminders": { "command": "bun", "args": [ "path/to/mcp-server-apple-reminders/src/index.ts" ] } } }
参数说明:
- 'server name': 'apple-reminders' (服务器名称,用于在客户端中标识和调用)
- 'command': 'bun' (启动服务器的命令,这里使用 Bun 运行时)
- 'args': '["path/to/mcp-server-apple-reminders/src/index.ts"]' (命令参数,指向服务器入口文件 'src/index.ts' 的绝对路径。你需要将 'path/to/mcp-server-apple-reminders' 替换为你本地仓库的实际路径)
请务必将 'path/to/mcp-server-apple-reminders' 替换为克隆到本地的 'mcp-server-apple-reminders' 仓库的实际绝对路径。 你可以使用 'pwd' 命令在终端中获取当前目录的绝对路径,然后在客户端配置中进行替换。
基本使用方法
- 启动服务器: 配置完成后,当 MCP 客户端尝试连接 'apple-reminders' 服务器时,服务器将自动启动。通常情况下,你无需手动启动服务器。
- 通过 LLM 交互: 在 MCP 客户端中,你可以使用自然语言指令指示 LLM 使用 'apple-reminders' 服务器的功能。例如,你可以对 LLM 说:
- "创建一个提醒事项,标题是“购买牛奶”,截止日期是明天上午9点"
- "列出我所有的提醒事项"
- "我有哪些购物清单里的提醒事项?"
LLM 将会解析你的指令,并调用 'apple-reminders' 服务器提供的工具来执行相应的操作,从而在你的 macOS “提醒事项” 应用中创建或查询提醒事项。
信息
分类
生产力应用