MCP Test

🚀 Google Calendar MCP Server

Google Calendar APIに接続し、予定やイベントに関する自然言語の質問に答えるMCP (Model Context Protocol) サーバーです。このサーバーを使用することで、ユーザーは自然な言葉でカレンダー情報を取得できます。

✨ 主な機能

• 自然言語クエリ：「今日の予定は何ですか？」や「明日の会議はありますか？」のような質問が可能です。
• 柔軟な時間範囲：特定の日付、日付範囲、または将来の期間のイベントを照会できます。
• 可用性チェック：特定の時間枠が空いているか、または重複しているかを確認できます。
• タイムゾーン対応：正確なスケジューリングのために、異なるタイムゾーンを扱うことができます。
• 構造化されたレスポンス：フォーマットされた、読みやすいカレンダー情報を取得できます。

📦 インストール

1. Google Calendar APIのセットアップ

オプションA: サービスアカウント (推奨 - OAuthリダイレクト不要)

1. Google Cloud Consoleにアクセスします。
2. 新しいプロジェクトを作成するか、既存のプロジェクトを選択します。
3. Google Calendar APIを有効にします。
4. 「APIs & Services」>「Credentials」に移動します。
5. 「Create Credentials」>「Service Account」をクリックします。
6. サービスアカウントを作成し、JSONキーファイルをダウンロードします。
7. 重要: サービスアカウントのメールアドレス（JSONファイル内の client_email）でGoogleカレンダーを共有します。

オプションB: OAuth 2.0 (従来の方法)

1. Google Cloud Consoleにアクセスします。
2. 新しいプロジェクトを作成するか、既存のプロジェクトを選択します。
3. Google Calendar APIを有効にします。
4. デスクトップアプリケーション用の認証情報（OAuth 2.0クライアントID）を作成します。
5. 認証情報のJSONファイルをダウンロードします。

2. 設定

サービスアカウントの場合:

1. サービスアカウントのJSONファイルを service-account-key.json にコピーするか、
2. 環境変数として設定します。

export GOOGLE_SERVICE_ACCOUNT_KEY='{"type": "service_account", ...}'

OAuth 2.0の場合:

1. ダウンロードした認証情報ファイルを credentials.json にコピーするか、
2. 環境変数として設定します。

export GOOGLE_CREDENTIALS_JSON='{"installed": {...}}'

3. 依存関係のインストール

必要な依存関係をインストールします。

pip install google-auth google-auth-oauthlib google-api-python-client mcp python-dateutil pytz