MCP AppleReminders

🚀 苹果提醒事项 MCP 工具使用说明

本工具基于小智 AI 的 MCP 功能开发（开发示例文档见：mcp-calculator），借助 MCP 协议可实现苹果提醒事项的创建与查询，能灵活设置提醒内容（标题和备注）以及提醒日期时间。

🚀 快速开始

此工具允许通过 MCP 协议创建和查询苹果提醒事项，你可以轻松设置提醒内容及日期时间。以下为你详细介绍使用步骤。

✨ 主要特性

创建提醒事项

• 设置提醒标题：此为必填项，明确提醒的核心内容。
• 添加提醒备注：选填项，可补充提醒的详细信息。
• 设置提醒日期：选填，格式需为 YYYY-MM-DD，如 2025-05-18。
• 设置提醒时间：选填，格式为 HH:MM:SS，且需先提供日期才有效。

查询提醒事项

• 按日期范围查询：支持使用自然语言日期表达，如“今天”“明天”“本周”等进行提醒事项的查询。
• 获取完整信息：查询结果将包含提醒事项的标题、备注、日期时间等完整信息。

📦 安装指南

安装依赖

确保已安装所需依赖，执行以下命令：

pip install -r requirements.txt

设置环境变量

设置环境变量，将 <your_mcp_endpoint> 替换为实际的 MCP 端点：

export MCP_ENDPOINT=<your_mcp_endpoint>

💻 使用示例

启动 MCP 服务器

使用 mcp_pipe.py 启动提醒事项服务器：

python mcp_pipe.py reminder.py

通过 AI 助手使用提醒事项工具

服务器启动并连接到 AI 助手后，可通过自然语言使用提醒事项工具。

基础用法

以下是创建提醒事项的基本示例：

- "帮我创建一个提醒事项，标题是'买牛奶'，备注是'超市特价'，日期是明天"
- "设置一个提醒，标题是'医生预约'，日期是2025年5月20日，时间是下午3点"
- "添加一个提醒：周五下午2:30开会"

高级用法

以下是查询提醒事项的示例，可根据不同的日期范围进行查询：

- "查询我今天的提醒事项"
- "明天有哪些提醒事项？"
- "列出本周的所有提醒"
- "查看5月20日的提醒事项"
- "周五有什么提醒？"

🔧 技术细节

测试工具

测试创建提醒事项

使用提供的测试脚本测试提醒事项创建功能：

python test_reminder.py

该脚本将运行以下测试用例：

1. 创建没有日期的提醒事项
2. 创建只有日期的提醒事项
3. 创建有日期和时间的提醒事项

测试查询提醒事项

使用提供的测试脚本测试提醒事项查询功能：

python test_get_reminders.py

该脚本将运行以下测试用例：

1. 查询今天的提醒事项
2. 查询明天的提醒事项
3. 查询本周的提醒事项

故障排除

常见问题

• 权限问题：确保应用有权限访问提醒事项，首次运行时可能会弹出权限请求对话框。
• 日期格式错误：确保日期格式为 YYYY-MM-DD。
• 时间格式错误：确保时间格式为 HH:MM:SS。

调试

若遇到问题，可查看终端中的日志输出获取更多信息。

功能测试

在真机上测试此功能时，需注意以下几点：

• 基本功能测试：创建不同类型的提醒事项（无日期、有日期、有日期和时间），并验证是否正确显示在苹果提醒事项应用中。
• 边界情况测试：测试特殊字符在标题和备注中的处理，以及过去的日期和时间、无效的日期和时间格式。
• 错误处理测试：测试缺少必填参数（标题）的情况，以及提供时间但不提供日期的情况。

📄 许可证

文档未提及许可证相关信息，若有相关内容可补充于此。

🔮 进一步改进

未来可能的改进方向：

1. 支持重复提醒（每天、每周、每月等）
2. 支持设置提醒优先级
3. 支持添加到特定提醒事项列表
4. 支持设置位置提醒
5. 支持查询和修改现有提醒事项