MCP AppleReminders

🚀 蘋果提醒事項 MCP 工具使用說明

本工具基於小智 AI 的 MCP 功能開發（開發示例文檔見：mcp-calculator），藉助 MCP 協議，可實現蘋果提醒事項的創建與查詢操作，能靈活設置提醒內容（標題和備註）以及提醒的日期時間。

🚀 快速開始

該工具使用便捷，按以下步驟操作即可開始使用：

1. 確保已安裝所需依賴：

pip install -r requirements.txt

2. 設置環境變量：

export MCP_ENDPOINT=<your_mcp_endpoint>

3. 啟動 MCP 服務器：

python mcp_pipe.py reminder.py

4. 服務器啟動並連接到 AI 助手後，就能通過自然語言使用提醒事項工具。

✨ 主要特性

創建提醒事項

• 提醒標題：必填項，明確提醒的核心內容。
• 提醒備註：選填項，可補充提醒的詳細信息。
• 提醒日期：選填，格式需為 YYYY - MM - DD。
• 提醒時間：選填，格式為 HH:MM:SS，需同時提供日期才有效。

查詢提醒事項

• 按日期範圍查詢：支持如“今天”“明天”“本週”等自然語言日期表達。
• 獲取完整信息：可獲取提醒事項的標題、備註、日期時間等完整信息。

📦 安裝指南

安裝依賴

pip install -r requirements.txt

設置環境變量

export MCP_ENDPOINT=<your_mcp_endpoint>

💻 使用示例

基礎用法

創建提醒事項

• "幫我創建一個提醒事項，標題是'買牛奶'，備註是'超市特價'，日期是明天"
• "設置一個提醒，標題是'醫生預約'，日期是 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（例如 2025 - 05 - 18）。
• 時間格式錯誤：確保時間格式為 HH:MM:SS（例如 14:30:00）。

調試

若遇到問題，可查看終端中的日誌輸出以獲取更多信息。

功能測試

在真機上測試此功能時，需注意以下幾點：

1. 基本功能測試：
   • 創建不同類型的提醒事項（無日期、有日期、有日期和時間）
   • 驗證提醒事項是否正確顯示在蘋果提醒事項應用中
2. 邊界情況測試：
   • 測試特殊字符在標題和備註中的處理
   • 測試過去的日期和時間
   • 測試無效的日期和時間格式
3. 錯誤處理測試：
   • 測試缺少必填參數（標題）的情況
   • 測試提供時間但不提供日期的情況

進一步改進

未來可能的改進方向：

1. 支持重複提醒（每天、每週、每月等）
2. 支持設置提醒優先級
3. 支持添加到特定提醒事項列表
4. 支持設置位置提醒
5. 支持查詢和修改現有提醒事項