Google Workspace MCP

🚀 Google Workspace MCP 説明ドキュメント

Google Workspace MCP（管理コンソールプラグイン）は、Google Workspaceサービスを統一的に管理および統合するためのツールです。以下の機能をサポートしています。

• アカウント管理：Google Workspaceアカウントの作成、認証、削除を含みます。
• ファイル操作：ファイルのアップロード、ダウンロード、共有、および権限管理を実現します。
• カレンダー統合：カレンダーイベントの作成、照会、および購読機能を提供します。
• メール処理：メールの送信、メールリストの管理、およびフィルター設定をサポートします。

🚀 クイックスタート

Google Workspace MCPを使用することで、Google Workspaceサービスの管理と統合が簡単に行えます。以下に、インストールと使用方法を説明します。

✨ 主な機能

• アカウント管理：Google Workspaceアカウントの作成、認証、削除が可能です。
• ファイル操作：ファイルのアップロード、ダウンロード、共有、および権限管理をサポートします。
• カレンダー統合：カレンダーイベントの作成、照会、および購読機能を提供します。
• メール処理：メールの送信、メールリストの管理、およびフィルター設定ができます。

📦 インストール

インストール手順

1. コードリポジトリをクローンします。

git clone https://github.com/your-repository.git
cd google-workspace-mcp

2. 依存関係をインストールします。

npm install

3. 環境変数を設定します。 config/mcp-config.json ファイルを作成して編集し、以下の内容を記入します。

{
  "google": {
    "client_id": "YOUR_GOOGLE_CLIENT_ID",
    "client_secret": "YOUR_GOOGLE_CLIENT_SECRET",
    "redirect_uri": "http://localhost:3000/callback"
  }
}

4. サービスを起動します。

npm start

💻 使用例

基本的な使用法

アカウント管理

認証フロー

1. 認証コマンドを実行します。

authenticate_workspace_account --email your.email@gmail.com

2. 指示に従ってOAuth 2.0認証フローを完了します。

アカウントリスト

すべての認証済みアカウント情報を表示します。

list_accounts

ファイル操作

ファイルのアップロード

ローカルファイルをGoogle Driveにアップロードします。

upload_drive_file --file /path/to/your/file.pdf --parent_folder "Documents"

ファイルのダウンロード

指定されたファイルをダウンロードします。

download_drive_file --id file_id_123456

カレンダー統合

カレンダーイベントの作成

新しいカレンダーイベントを追加します。

create_calendar_event --title 会議提醒 --description 項目討論 --start_time "2023-10-01T14:00:00"

📚 ドキュメント

詳細な使用方法については、APIドキュメントを参照してください。

🔧 技術詳細

未来計画

新サービスの追加

• Admin SDKサポート
• より多くのGoogleサービスの統合

テスト戦略

単体テスト方法

1. 簡易モック
   • 静的なモック応答を使用して、テストの予測可能性を確保します。
   • 単体テストで複雑なエンドツーエンドのモックを行わないようにします。
   • 一度に1つの機能モジュールをテストします。
   • 外部依存関係（OAuth、ファイルシステムなど）を簡単な実装でモックします。
2. テストの組織化
   • 機能別にテストをグループ化します（例：アカウント操作、ファイル操作）。
   • 明確で説明的なテスト名を使用します。
   • テストを焦点を絞って独立させます。
   • 各テストの間でモックとモジュールをリセットします。
3. モック管理
   • jest.resetModules() を使用してクリーンな状態を保ちます。
   • モックを変更した後、モジュールを再読み込みします。
   • モック関数の呼び出しを明示的に追跡します。
   • 関数の呼び出しとその結果を検証します。
4. ファイルシステムテスト
   • 簡単なJSON構造を使用してテストします。
   • データの正確性に焦点を当て、形式ではなくデータの正しさをテストします。
   • エラーシナリオ（ファイルがない、無効なJSONなど）をテストします。
   • 具体的な実装詳細に関係なくファイル操作を検証します。
5. OAuthモック
   • OAuthフローを十分にモックして、実際の認証プロセスを回避します。
   • テスト環境と本番環境を分離して確保します。

ベストプラクティス

セキュリティに関する注意事項

• 資格情報管理：Google OAuth資格情報（client_idとclient_secret）は、暗号化された設定ファイルまたは環境変数などの安全な場所に保存することをお勧めします。
• アクセス制御：厳格な権限ポリシーを実施し、承認されたユーザーのみが機密操作を実行できるようにします。

パフォーマンス最適化

• 非同期処理：大量のデータ操作には、非同期メソッドを使用して効率を向上させることをお勧めします。
• エラー処理：重要な操作には適切なエラーキャッチと復旧メカニズムを追加し、サービスの中断を防ぎます。

トラブルシューティング

一般的な問題

1. 認証失敗
   • 提供されたメールアドレスが正しく有効であることを確認します。
   • OAuth資格情報が正しく構成されていることを確認します。
2. APIリクエストのタイムアウト
   • ネットワーク接続の状態を確認します。
   • リクエストのタイムアウト設定を増やすか、データ転送量を最適化することを検討します。

付録

コマンドラインツールのリファレンス

• authenticate_workspace_account：Google WorkspaceアカウントのOAuth認証に使用します。
• list_accounts：すべての認証済みGoogle Workspaceアカウント情報を表示します。
• upload_drive_file：指定されたGoogle Driveフォルダにファイルをアップロードします。
• download_drive_file：特定のIDのGoogle Driveファイルをダウンロードします。
• create_calendar_event：新しいカレンダーイベントを作成します。

連絡先

ヘルプやフィードバックが必要な場合は、以下の連絡先までお問い合わせください。

• メール：support@googlworkspace.com
• 電話：+1 (800) 123-4567