MCP Calender Agent

🚀 MCPベースのiCalサーバ

このプロジェクトは、MCPプロトコルに基づくiCalサーバの実装です。主な機能は、カレンダーイベントの作成、検索、管理です。元の実装と比較して、このプロジェクトでは全く新しいアーキテクチャ設計を採用し、OpenAIエージェントを使用して自然言語リクエストを処理し、クライアントの統合を簡素化しています。

✨ 主な機能

• シングルポイントアクセス：1つのMCPツールですべてのカレンダー操作を完了できます。
• インテリジェントエージェント：組み込みのOpenAIエージェントが、自然言語リクエストを解析し、具体的な操作コマンドに変換します。
• コンテキスト認識：セッションレベルのコンテキスト追跡をサポートし、対話体験を向上させます。
• 統合の簡素化：クライアントは1つのツールを呼び出すだけでよく、統合の複雑さが軽減されます。

📦 インストール

環境要件

• Python 3.8以上
• OpenAIアカウントとAPIキー
• macOSシステム（PyObjCに依存しているため）

インストール手順

# リポジトリをクローン
git clone https://github.com/yourusername/mcp-ical.git
cd mcp-ical

# 依存関係をインストール
pip install openai pyobjc

💻 使用例

基本的な使用法

1. OpenAI APIキーを設定します。
   • 設定ファイル config.json を作成または編集します。
   • 以下の内容を追加します。

     {
         "openai_api_key": "your-api-key-here"
     }
     

2. サービスを起動します。

   uv run mcp-ical
   

3. 例としての使用法：

   リクエストを送信："/ABSOLUTE/PATH/TO/PARENT/FOLDER/mcp-ical" mcp-ical
   

📚 ドキュメント

コアコンポーネント

1. カレンダーエージェント（CalendarAgent）
   • 自然言語コマンドを解析し、対応する操作を生成します。
   • OpenAIのAgent SDKを使用して実装されています。
   • テキスト、音声など、複数の対話方式をサポートしています。
2. イベントマネージャー（EventManager）
   • 具体的なカレンダー操作（イベントの作成、更新、削除など）を処理します。
   • macOSシステムのカレンダーサービスと統合されています。
   • 詳細なログ記録とエラー処理を提供します。

🔧 技術詳細

1. リクエストフロー：

   クライアント -> CalendarAgent -> EventManager -> システムカレンダー
   

2. コア依存関係：
   • OpenAI SDK：インテリジェントエージェント機能を実現するために使用されます。
   • PyObjC：macOSシステムのカレンダーサービスとのやり取りに使用されます。

既知の問題

• 繰り返しイベントの問題
  • 非標準の繰り返しパターンが正しく設定されない場合があります。
  • より強力なLLMモデルを使用すると、この問題を改善できる可能性があります。
  • 終日の繰り返しイベントの通知時間が1日ずれることがあります。

貢献の方法

どのような形のフィードバックや貢献も歓迎します。以下の手順に従ってください。

1. このリポジトリをあなたのアカウントにForkします。
2. 機能ブランチを作成します（例：feature/new-feature）。
3. 変更をコミットします。
4. ブランチをリモートリポジトリにプッシュします。
5. メインブランチにPull Requestを送信します。

📄 ライセンス

このプロジェクトはMITライセンスに基づいています。詳細については、LICENSE ファイルを参照してください。

謝辞

• 元のプロジェクト：Omar-V2の mcp-ical をベースにしています。
• プロトコルサポート：Model Context Protocol を使用しています。
• カレンダー統合：PyObjC に依存しています。
• インテリジェントエージェント：OpenAI Agent SDK でサポートされています。