Google Calendar MCP

🚀 Google Calendar カレンダー MCP サーバー

Google Calendar カレンダー MCP（Minimal Configuration Package か他の特定用語かもしれません。文脈ではカスタムプロトコルやモジュールを指す可能性があります）サーバーは、Google Calendar と統合するためのローカル実行ツールです。OAuth 2.0 を通じて認証を行い、コマンドラインインターフェース (CLI) を提供してカレンダーデータを管理および操作します。

🚀 クイックスタート

このセクションでは、Google Calendar カレンダー MCP サーバーをすぐに起動するための手順を説明します。

クイックセットアップ

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

   git clone <repository-url>
   cd google-calendar-mcp-server
   

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

   npm install
   

3. サーバーを起動（開発モード）

   npm start
   

✨ 主な機能

• カレンダー管理：カレンダーの作成、読み取り、更新、削除が可能です。
• イベント操作：イベントの追加、照会、更新、キャンセルができます。
• OAuth 2.0 サポート：Google アカウントを通じた認証が可能です。
• ローカル実行：サーバー不要で、ローカルマシンで直接実行できます。

📦 インストール

依存関係のインストール

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

   git clone <repository-url>
   cd google-calendar-mcp-server
   

2. Node.js と npm をインストール

   • Node.js バージョン 14 以上がインストールされていることを確認してください。
   • npm は通常 Node.js と一緒にインストールされます。

3. プロジェクトの依存関係をインストール

   npm install
   

サーバーの起動

開発モードで起動

npm start

本番モードで起動

node build/index.js

💻 使用例

基本的な使用法

カレンダーの作成

node build/index.js createCalendar --name "My New Calendar"

すべてのカレンダーを取得

node build/index.js listCalendars

📚 ドキュメント

コマンドラインインターフェース (CLI)

完全な CLI ドキュメントは プロジェクトドキュメント を参照してください。

開発ドキュメント

詳細な技術ドキュメントは 開発者ガイド を参照してください。

🔧 技術詳細

プロジェクト構造

google-calendar-mcp-server/
├── src/                 # ソースコードフォルダ
│   ├── index.ts        # エントリーファイル
│   ├── calendar.ts     # カレンダーのビジネスロジック
│   └── event.ts       # イベント処理ロジック
├── build/              # ビルド出力ディレクトリ
│   └── index.js       # 起動エントリー
└── config.json         # 設定ファイルのサンプル

コアモジュール

src/calendar.ts

カレンダーの CRUD 操作を担当し、Google Calendar API を統合しています。

src/event.ts

イベントの作成、照会、削除操作を処理し、カレンダーモジュールに依存しています。

🤝 貢献ガイド

貢献いただけることを歓迎します！開発への参加方法やコードの提出方法については 貢献者ガイド を参照してください。

📄 ライセンス

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