Apple Reminder MCP 工具使用说明

此工具基于小知AI的MCP功能开发（参见开发示例文档：mcp-calculator），允许通过MCP协议创建和查询Apple提醒事项，并能够设置提醒内容（标题和备注）以及提醒日期和时间。

功能

创建提醒事项

• 设置提醒标题（必填）
• 添加提醒备注（可选）
• 设置提醒日期（可选，格式：YYYY-MM-DD）
• 设置提醒时间（可选，格式：HH:MM:SS，需要指定日期以确保有效性）

查询提醒事项

• 按日期范围查询提醒事项（如“今天”、“明天”、“本周”等）
• 获取提醒事项的完整信息（标题、备注、日期和时间）
• 支持自然语言日期表达（如“今天”、“明天”、“星期五”等）

安装与配置

1. 确保已安装所需的依赖项：

pip install -r requirements.txt

2. 设置环境变量：

export MCP_ENDPOINT=<your_mcp_endpoint>

使用说明

1. 启动MCP服务器

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

python mcp_pipe.py reminder.py

2. 通过AI助手使用提醒工具

一旦服务器启动并连接到AI助手，您可以通过自然语言使用提醒工具：

创建提醒事项

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

查询提醒事项

• 查找我今天的提醒事项
• 明天有哪些提醒事项
• 列出本周的所有提醒事项
• 查看5月20日的提醒事项
• 星期五有哪些提醒事项

测试工具

测试创建提醒事项

您可以使用提供的测试脚本来测试提醒创建功能：

python test_reminder.py

测试查询提醒事项

您可以使用提供的测试脚本来测试提醒查询功能：

python test_get_reminders.py

创建提醒事项的测试脚本将运行多个测试用例，包括：

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

查询提醒事项的测试脚本将运行以下测试用例：

1. 检查今天的提醒事项
2. 检查明天的提醒事项
3. 搜索本周的提醒事项

故障排除

常见问题

1. 权限问题确保您的应用程序有权访问提醒事项。在首次运行时可能会弹出权限请求对话框。
2. 日期格式错误确保日期格式为YYYY-MM-DD（例如2025年5月18日）。
3. 时间格式错误确保时间格式为HH:MM:SS（例如14:30:00）。

调试

如果您遇到任何问题，可以查看日志输出以获取更多信息。日志将在终端中显示。

功能测试

在实际机器上测试此功能时，请注意以下几点：

1. 基本功能测试：

   • 创建不同类型的提醒事项（无日期、有日期、有日期和时间）
   • 验证提醒事项是否正确显示在Apple提醒应用中

2. 边界条件测试：

   • 测试标题和备注中的特殊字符处理
   • 测试过去的日期和时间
   • 测试无效的日期和时间格式

3. 错误处理测试：

   • 测试缺少必需参数（标题）
   • 测试提供时间但未提供日期的情况

进一步改进

可能的未来改进方向：

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