Google Workspace

🚀 クイックスタート

このプロジェクトは、Google Workspaceの操作を簡素化するためのライブラリです。以下に、インストール方法や基本的な使用例を説明します。

📦 インストール

プロジェクト依存関係

npm install google-workspace-mcp --save

設定説明

アカウントマネージャーインスタンス

import { AccountManager } from 'google-workspace-mcp';

const accountManager = new AccountManager({
  configPath: './config',
  scopes: ['https://www.googleapis.com/auth/gmail.readonly']
});

デフォルト設定パス

• Windows: C:\Users\<CurrentUser>\.mcp\google-workspace-mcp
• macOS/Linux: ~/.mcp/google-workspace-mcp

✨ 主な機能

アカウント操作

await accountManager.authenticate('user123', {
  type: 'password',
  credentials: {
    username: 'your_username',
    password: 'your_password'
  }
});

メール処理

const gmail = accountManager.getGmailService('user123');
const inbox = await gmail.inbox.list();

カレンダー操作

const calendar = accountManager.getCalendarService('user123');
const events = await calendar.calendar.events.list('primary');

📚 ドキュメント

詳細情報は API ドキュメント を参照してください。

🔮 未来の計画

新しいサービスの追加

• Admin SDK サポート
• その他のGoogleサービスの統合

🔧 テスト戦略

単体テスト方法

1. モッキングの簡素化

   • テストの予測可能性を確保するために、静的なモック応答を使用します。
   • 単体テストでは複雑なエンドツーエンドのモックを避けます。
   • 一度に1つの機能モジュールのみをテストします。
   • 外部依存関係（OAuth、ファイルシステムなど）には簡単な実装を使用します。

2. テストの組織化

   • 機能別にテストをグループ化します（例：アカウント操作、ファイル操作）。
   • 明確で説明的なテスト名を使用します。
   • テストを集中的かつ分離して維持します。
   • 各テストの間でモックとモジュールをリセットします。

3. モック管理

   • jest.resetModules() を使用してクリーンな状態を確保します。
   • モックを変更した後はモジュールを再読み込みします。
   • モック関数の呼び出しを明示的に追跡します。
   • 関数の呼び出しと結果の両方を検証します。

4. ファイルシステムテスト

   • 簡単なJSON構造を使用します。
   • データの正確性に重点を置き、形式は問いません。
   • エラーシナリオ（ファイルがない、無効なJSONなど）をテストします。
   • 実装の詳細を知らなくてもファイル操作を検証できます。

5. トークン処理

   • 静的な応答を使用してトークンの検証をモックします。
   • 成功と失敗のシナリオをそれぞれテストします。
   • OAuthの複雑さを無視し、アカウントマネージャーのトークン処理ロジックに焦点を当てます。

テストの実行

# すべてのテストを実行
npm test

# 指定されたテストファイルを実行
npm test path/to/test.ts

# カバレッジ付きでテストを実行
npm test -- --coverage

# CIビルドですべてのカバレッジ付きテストを実行
npm run test:ci

💡 ベストプラクティス

1. 認証

   • MCP設定で資格情報を安全に保存します。
   • 最小限の必要な権限範囲を使用します。
   • トークンの更新を適切に処理します。

2. エラー処理

   • 応答のステータスコードをチェックします。
   • 認証エラーを適切に処理します。
   • 完全なログ記録メカニズムを構築します。

3. 設定管理

   • 本番環境で資格情報を公開しないようにします。
   • APIキーを定期的に更新します。
   • 環境変数を使用して機密情報を管理します。

4. パフォーマンス最適化

   • 適切なリクエストタイムアウト時間を設定します。
   • 過負荷を防ぐためにレート制限を実施します。
   • キャッシュを使用してAPIリクエストの回数を減らします。

🌐 プロジェクトの場所

• GitHub: https://github.com/yourusername/google-workspace-mcp
• npm: https://www.npmjs.com/package/google-workspace-mcp

📄 ライセンス

MIT License