G2n MCP Gcal Sse

🚀 G2N MCP 谷歌日历 SSE サーバー

🌍 この README は複数の言語に対応しています：

• 🇺🇸 English
• 🇧🇷 Portuguese

このサーバーは、Model Context Protocol (MCP) に基づいて構築され、Server-Sent Events (SSE) を通じて Google カレンダーとの統合を提供します。AI モデルや Cursor、Claude、n8n などのアプリケーションが Google カレンダーとやり取りできるように、Google カレンダー機能をツールとして提供します。

🚀 クイックスタート

前提条件

• Docker と Docker Compose をインストールする
• Google Cloud プロジェクトでカレンダー API を有効にする
• Google OAuth 2.0 クライアント ID とクライアントシークレットを取得する

環境変数

サーバーで使用される環境変数は次のとおりです。

PORT=3001                                # サーバーポート（デフォルト：3001）
PUBLIC_URL=https://your-domain.com       # OAuth コールバック用のパブリック URL
GOOGLE_CLIENT_ID=${GOOGLE_CLIENT_ID}     # Google OAuth クライアント ID
GOOGLE_CLIENT_SECRET=${GOOGLE_CLIENT_SECRET} # Google OAuth クライアントシークレット
OAUTH_REDIRECT_PATH=/oauth/callback      # OAuth コールバックパス（デフォルト：/oauth/callback）

⚠️ 重要な注意事項

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

サポートされる言語

デフォルトでは、次の 2 つの言語がサポートされています。

• 中国語 (zh-CN)
• 英語 (en-US)

✨ 主な機能

このサーバーは、Google カレンダー管理のために次の 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）

📦 インストール

インストール手順

1. リポジトリをクローンする

git clone https://github.com/your-repository.git
cd G2N-MCP-GoogleCalendar-SSE-Server

2. 依存関係をインストールする

npm install

3. 環境変数を構成する

   • .env ファイルを作成し、以下の内容を追加します。

     PORT=3001
     PUBLIC_URL=https://your-domain.com
     GOOGLE_CLIENT_ID=あなたのGoogleクライアントID
     GOOGLE_CLIENT_SECRET=あなたのGoogleクライアントシークレット
     

4. サーバーを起動する

npm start

💻 使用例

基本的な使用法

サーバーを起動した後、次のエンドポイントを使用してサービスにアクセスできます。

• GET /api/list-calendars：すべてのカレンダーをリストする
• GET /api/get-calendar?calendarId=your_calendar_id：特定のカレンダーの詳細情報を取得する
• GET /api/list-events?calendarId=your_calendar_id：フィルターオプションに従ってイベントをリストする

リクエストの例

curl http://localhost:3001/api/list-calendars

📄 ライセンス

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

关于 G2NTech

このプロジェクトは Gabriel Augusto によって G2NTech で開発およびメンテナンスされています。

サポートする 💜

このプロジェクトが役立つと思った場合は、PIX を通じてサポートを検討してください。

• PIX Key: gabriel@g2ngroup.com