Scan to join WeChat grouparticle
README
🚀 苹果提醒事项 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
该脚本将运行以下测试用例：
- 创建没有日期的提醒事项
- 创建只有日期的提醒事项
- 创建有日期和时间的提醒事项
测试查询提醒事项
使用提供的测试脚本测试提醒事项查询功能：
python test_get_reminders.py
该脚本将运行以下测试用例：
- 查询今天的提醒事项
- 查询明天的提醒事项
- 查询本周的提醒事项
故障排除
常见问题
- 权限问题：确保应用有权限访问提醒事项，首次运行时可能会弹出权限请求对话框。
- 日期格式错误：确保日期格式为
YYYY-MM-DD。 - 时间格式错误：确保时间格式为
HH:MM:SS。
调试
若遇到问题，可查看终端中的日志输出获取更多信息。
功能测试
在真机上测试此功能时，需注意以下几点：
- 基本功能测试：创建不同类型的提醒事项（无日期、有日期、有日期和时间），并验证是否正确显示在苹果提醒事项应用中。
- 边界情况测试：测试特殊字符在标题和备注中的处理，以及过去的日期和时间、无效的日期和时间格式。
- 错误处理测试：测试缺少必填参数（标题）的情况，以及提供时间但不提供日期的情况。
📄 许可证
文档未提及许可证相关信息，若有相关内容可补充于此。
🔮 进一步改进
未来可能的改进方向：
- 支持重复提醒（每天、每周、每月等）
- 支持设置提醒优先级
- 支持添加到特定提醒事项列表
- 支持设置位置提醒
- 支持查询和修改现有提醒事项