MCP AppleReminders

🚀 アップルリマインダーMCPツールの使用説明

このツールは、小智AIのMCP機能をベースに開発されています（開発サンプルドキュメントはこちら）。MCPプロトコルを通じてアップルリマインダーの作成と照会が可能で、リマインダーの内容（タイトルとメモ）および日時を設定できます。

✨ 主な機能

リマインダーの作成

• リマインダーのタイトルを設定（必須）
• リマインダーのメモを追加（任意）
• リマインダーの日付を設定（任意、形式：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-05-18）であることを確認してください。
3. 時間形式のエラー：時間形式がHH:MM:SS（例：14:30:00）であることを確認してください。

デバッグ

問題が発生した場合は、ログ出力を確認して詳細な情報を取得できます。ログはターミナルに表示されます。

📈 機能テスト

実機でこの機能をテストする際には、以下の点に注意してください：

1. 基本機能のテスト：

   • さまざまなタイプのリマインダー（日付なし、日付あり、日付と時間あり）を作成する
   • リマインダーがアップルリマインダーアプリに正しく表示されることを確認する

2. 境界条件のテスト：

   • タイトルとメモに特殊文字を使用した場合の処理をテストする
   • 過去の日付と時間をテストする
   • 無効な日付と時間形式をテストする

3. エラー処理のテスト：

   • 必須パラメータ（タイトル）が欠落している場合をテストする
   • 時間を指定して日付を指定しない場合をテストする

🚀 将来の改善点

将来的に可能な改善方向は以下の通りです：

1. 繰り返しリマインダー（毎日、毎週、毎月など）のサポート
2. リマインダーの優先度設定のサポート
3. 特定のリマインダーリストへの追加のサポート
4. 位置リマインダーの設定のサポート
5. 既存のリマインダーの照会と修正のサポート