MCP Google Workspace

🚀 モデルコンテキストプロトコルGoogle Workspaceサーバー

このプロジェクトは、Google Workspaceと連携するサーバーアプリケーションで、GmailやGoogleカレンダーなどの機能を利用できます。

🚀 クイックスタート

このセクションでは、プロジェクトのインストールと起動方法を説明します。

📦 インストール

プロジェクトの依存関係をインストールするには、以下のコマンドを実行してください。

npm install

💻 使用例

基本的な使用法

サービスの起動

サーバーを起動するには、以下のコマンドを実行してください。

npm start

オプションパラメータ:

• --gauth-file：OAuth2認証情報ファイルのパスを指定します（デフォルトは./.gauth.json）
• --accounts-file：アカウント設定ファイルのパスを指定します（デフォルトは./.accounts.json）
• --credentials-dir：OAuth認証情報を保存するディレクトリを指定します（デフォルトは現在のディレクトリ）

例:

npm start -- --gauth-file ./config/gauth.json --accounts-file ./config/accounts.json

高度な使用法

利用可能なツール

アカウント管理

1. 構成されたすべてのGoogleアカウントをリストする

• コマンド: gmail_list_accounts または calendar_list_accounts
• 機能: すべての構成されたGoogleアカウントの情報を表示します。アカウントのメタデータと説明が含まれます。
• ユーザーIDは不要です。

メール機能ツール

1. メールを検索する

• コマンド: gmail_query_emails
• 機能: Gmailのクエリ構文を使用してメールを検索します（例: 'is:unread', 'from:example@gmail.com', 'newer_than:2d', 'has:attachment'）
• 逆時間順に並べられたメールのリストを返し、メタデータと内容の要約が含まれます。

2. メールを取得する

• コマンド: gmail_get_email
• 機能: IDを指定して完全なメール内容を取得します。本文と添付ファイルの情報が含まれます。

3. メールを一括取得する

• コマンド: gmail_bulk_get_emails
• 機能: 複数のメールの完全な内容を一度に取得します。一括処理に適しています。

4. 下書きを作成する

• コマンド: gmail_create_draft
• 機能: 新しいメールの下書きを作成します。
• Cc受信者をサポートしています。

5. 下書きを削除する

• コマンド: gmail_delete_draft
• 機能: IDを指定して下書きメールを削除します。

6. メールに返信する

• コマンド: gmail_reply
• 機能: 既存のメールに返信します。
• オプション: すぐに送信するか、下書きとして保存するかを選択できます。
• Cc（すべての受信者）をサポートしています。

7. 添付ファイルを取得する

• コマンド: gmail_get_attachment
• 機能: メールの添付ファイルをダウンロードします。
• オプション: ローカルディスクに保存するか、埋め込みリソースとして返すかを選択できます。

8. 添付ファイルを一括保存する

• コマンド: gmail_bulk_save_attachments
• 機能: 複数の添付ファイルを一度に保存します。

9. メールをアーカイブする

• コマンド: gmail_archive または gmail_bulk_archive
• 機能: メールを受信トレイから移動します。
• 単一または一括操作をサポートしています。

カレンダー機能ツール

1. カレンダーをリストする

• コマンド: calendar_list
• 機能: すべてのアクセス可能なカレンダーを表示します。
• カレンダーのメタデータ、アクセス権限、タイムゾーン情報が含まれます。

2. イベントを取得する

• コマンド: calendar_get_events
• 機能: 指定された日付範囲内のイベントを取得します。
• 複数のカレンダーをサポートしています。
• フィルタオプション（削除されたイベント、最大結果数）
• タイムゾーンをカスタマイズできます。

3. イベントを作成する

• コマンド: calendar_create_event
• 機能: 新しいカレンダーイベントを作成します。
• 参加者とリマインダーをサポートしています。
• 場所と説明フィールドをサポートしています。
• タイムゾーンの処理が行われます。

4. イベントを削除する

• コマンド: calendar_delete_event
• 機能: IDを指定してイベントを削除します。
• オプション: すぐに送信するか、下書きとして保存するかを選択できます。
• Cc（すべての受信者）をサポートしています。

📚 ドキュメント

プロジェクト構造

src/
├── main.ts        # メインプログラムのエントリポイント
├── config/       # 設定フォルダ
│   ├── gauth.json
│   └── accounts.json
└── utils/         # ユーティリティ関数
    ├── gmail-service.ts
    └── calendar-service.ts

開発コマンド

# 開発サーバーを起動する
npm run dev

# プロジェクトをビルドする
npm run build

# テストを実行する
npm test

📄 ライセンス

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