Apple Calendars

🚀 MCP Apple カレンダー

このモジュールは、macOS 上で AI モデルが標準化されたインターフェースを通じてカレンダーデータにアクセスし、操作するためのモデルコンテキストプロトコル (MCP) サーバーです。

🚀 クイックスタート

MCP Apple カレンダーを使用することで、macOS 上の AI モデルがカレンダーデータを操作できるようになります。以下の手順に従ってセットアップしてください。

✨ 主な機能

• AI モデルが標準化されたインターフェースを通じてカレンダーデータにアクセスし、操作できます。
• 複数の日付形式に対応しています。

📦 インストール

前提条件

• macOS 12.0 以上
• Node.js 16.0 以上
• カレンダー API ブリッジ をローカルで実行

インストール手順

1. このリポジトリをクローンします。
2. 依存関係をインストールします。

   npm install
   

3. TypeScript コードをビルドします。

   npm run build
   

💻 使用例

基本的な使用法

1. カレンダー API ブリッジが 8080 ポートで実行されていることを確認します。
2. MCP サーバーを起動します。

   npm start
   

高度な使用法

MCP サーバーは、AI モデルに以下のツールを提供します。

• getCalendars：利用可能なすべてのカレンダーをリストします。
• getCalendarEvents：特定のカレンダーからイベントを取得します。
• createCalendarEvent：カレンダーに新しいイベントを作成します。
• updateCalendarEvent：既存のイベントを更新します。
• deleteCalendarEvent：カレンダーからイベントを削除します。

日付形式

イベントを作成または更新する際には、以下のいずれかの日付形式を使用できます。

1. ミリ秒と Z タイムゾーンを含む ISO8601（推奨）：

   2025-03-09T10:00:00.000Z
   

2. ミリ秒を含まない ISO8601：

   2025-03-09T10:00:00
   

3. T をスペースに置き換えた ISO8601：

   2025-03-09 10:00:00
   

4. スラッシュを使用した ISO8601：

   2025/03/09 10:00:00
   

カレンダー API ブリッジはこれらの日付形式を自動的に処理するように更新されています。

開発

開発モードでサーバーを実行し、自動リロードを有効にするには、以下のコマンドを実行します。

npm run dev

📄 ライセンス

MIT