G2N MCP Google Calendar SSE Server

G2N MCP Google Calendar SSE サーバー

🌎 この README は複数の言語で利用できます：

• 🇺🇸 英語
• 🇧🇷 ポルトガル語

概要

G2N MCP Google Calendar SSE サーバーは、Server-Sent Events（SSE）を通じて Google Calendar と連携する Model Context Protocol（MCP）サーバーの実装です。このサーバーは、Cursor、Claude、n8n などの AI モデルやアプリケーションが Google Calendar を操作するためのツールとして、Google Calendar の機能を提供します。

最新バージョンの MCP SDK で構築されたこのサーバーは、MCP 対応モデルと Google Calendar サービスとの堅牢な連携を実現します。

機能

このサーバーは、Google Calendar を管理するための以下の MCP ツールを提供します。

• list-calendars：利用可能なすべてのカレンダーを一覧表示
• get-calendar：特定のカレンダーの詳細を取得
• list-events：フィルタリングオプションを指定して、カレンダーの予定を一覧表示
• get-event：特定の予定の詳細情報を取得
• create-event：新しいカレンダーの予定を作成
• update-event：既存のカレンダーの予定を更新
• delete-event：カレンダーの予定を削除
• list-colors：予定とカレンダーで利用可能な色を一覧表示

v1.1.0 の新機能

• 設定可能なログレベルを備えた包括的なロギングシステム
• モニタリングを強化するリクエスト／レスポンスのロギングミドルウェア
• 接続を安定させる SSE ハートビートの実装
• エラー処理とデバッグ機能の強化
• データディレクトリの適切な権限設定による Docker 設定の改善
• トークン管理を強化した OAuth フロー
• 保守性を高めるコードのリファクタリング

v1.0.1 の新機能

• 初の安定版リリース
• Docker と Docker Swarm に対応した本番環境向け構成
• 環境変数の設定を強化
• デプロイシナリオに応じた接続 URL の改善
• n8n 連携に関するドキュメントを改善
• Traefik の設定ガイドライン
• マルチプラットフォーム対応の Docker イメージ（amd64、arm64、arm/v7）

はじめに

前提条件

• Docker と Docker Compose がインストールされていること
• Calendar API を有効にした Google Cloud プロジェクト
• OAuth 2.0 クライアント ID とクライアントシークレット

環境変数

サーバーでは以下の環境変数を使用します。

PORT=3001                                # Server port (default: 3001)
PUBLIC_URL=https://your-domain.com       # Public URL for OAuth callbacks
GOOGLE_CLIENT_ID=${GOOGLE_CLIENT_ID}     # Google OAuth Client ID
GOOGLE_CLIENT_SECRET=${GOOGLE_CLIENT_SECRET} # Google OAuth Client Secret
OAUTH_REDIRECT_PATH=/oauth/callback      # OAuth callback path (default: /oauth/callback)

重要な注意事項：

• Traefik を使用する場合は、PORT 環境変数で指定したポートを参照するように設定してください
• Google のリフレッシュトークンを正常に受け取るために、これは非常に重要です
• OAuth コールバックが機能するには、PUBLIC_URL がインターネットからアクセス可能である必要があります

認証フロー

1. Docker を使用するか、サーバーを直接起動します
2. ブラウザーで /auth エンドポイントにアクセスします
3. Google アカウントを使用して、アプリケーションに権限を付与します
4. 認証後、継続的にアクセスできるよう、サーバーがリフレッシュトークンを保存します
5. 必要に応じて、サーバーがトークンを自動的に更新します

アクセスを取り消すには、/revoke エンドポイントを使用します。

curl -X POST https://your-domain.com/revoke

MCP 対応アプリケーションでの使用

接続 URL

デプロイシナリオに応じて、適切な URL 形式を使用してください。

1. Docker Swarm／n8n 内部アクセス：

   http://[stack-service-name]:3001/sse
   

   例：スタック内のサービス名が g2n-mcp-gcal-sse の場合は、次を使用します。

   http://g2n-mcp-gcal-sse:3001/sse
   

2. 外部アクセス（Cursor、Claude など）：

   https://your-domain.com/sse
   

3. ローカル開発：

   http://localhost:3001/sse
   

Cursor AI

設定で MCP 接続を構成すると、このサーバーを Cursor AI で使用できます。

1. Cursor の設定を開きます
2. パブリックドメインを使用して MCP サーバーの URL を設定します。

   https://your-domain.com/sse
   

3. AI コマンドを通じて Google Calendar の機能を使い始めます

Claude Desktop

Claude Desktop の場合：

1. Settings > MCP に移動します
2. パブリック URL を使用して新しい MCP 接続を追加します。

   https://your-domain.com/sse
   

3. 会話を通じて Google Calendar の機能を利用します

n8n

1. n8n で新しい MCP ノードを追加します
2. 内部サービス URL を使用して MCP ノードを設定します。

   http://[stack-service-name]:3001/sse
   

3. ワークフローで公開されているカレンダーツールを使用します

ライセンス

このプロジェクトは MIT ライセンスの下で公開されています。詳細は LICENSE ファイルを参照してください。

G2NTech について

このプロジェクトは、G2NTech の Gabriel Augusto が開発・保守しています。

プロジェクトを支援する 💜

このプロジェクトが役に立った場合は、PIX でのご支援をご検討ください。

• PIX キー： [email protected]