Gdrive MCP Server

🚀 Google Drive MCP サーバー

強力なモデルコンテキストプロトコル (MCP) サーバーで、Google Drive とのシームレスな統合を提供し、AI モデルが Google Drive 内のファイルを検索、リスト表示、読み取りできるようにします。

🚀 主な機能

ツール

1. gdrive_search

Google Drive 内で強力な全文検索機能を使ってファイルを検索します。

• 入力：

  {
    "query": "string (検索クエリ)"
  }
  

• 出力：以下の情報を含むファイルリスト
  • ファイル名
  • MIME タイプ
  • ファイル ID
  • 最終更新日時
  • ファイルサイズ

2. gdrive_read_file

Google Drive のファイル ID を使用して直接ファイル内容を読み取ります。

• 入力：

  {
    "file_id": "string (Google Drive ファイル ID)"
  }
  

• 出力：適切な形式に変換されたファイル内容

自動ファイル形式処理

サーバーはさまざまな Google Workspace ファイルタイプを自動的に処理します。

• 📝 Google Docs → Markdown
• 📊 Google Sheets → CSV
• 📊 Google Presentations → テキスト
• 🎨 Google Drawings → PNG
• 📄 テキスト/JSON ファイル → UTF-8 テキスト
• 📦 その他のファイル → Base64 エンコード

🚀 クイックスタート

前提条件

• Node.js (v14 以上)
• npm (5.7 以上)

インストール

npm install gdrive-mcp-server

使用例

import { GDriveMCP } from 'gdrive-mcp-server';

async function main() {
  const gdrive = new GDriveMCP({
    credentialsPath: './credentials.json',
    tokenPath: './token.json'
  });

  // ファイルを検索
  const files = await gdrive.search({ query: 'quarterly report' });
  console.log('検索結果:', files);

  // ファイル内容を読み取り
  const contents = await gdrive.read('your-file-id');
  console.log('ファイル内容:', contents);
}

main().catch(console.error);

📦 設定

Credentials ファイルの作成

credentials.json に Google Drive の認証情報を追加します。

{
  "type": "service_account",
  "project_id": "your-project-id",
  "private_key_id": "your-private-key-id",
  "private_key": "your-private-key",
  "client_email": "your-client-email",
  "token_uri": "https://oauth2.googleapis.com/token"
}

認証フロー

1. Google アカウントを使って Google Cloud Console にアクセスします。
2. 新しいプロジェクトを作成するか、既存のプロジェクトを選択します。
3. Drive API v3 API を有効にします。
4. サービスアカウントを作成し、JSON キーファイル（credentials.json）をダウンロードします。

承認

必要な OAuth トークンを取得するためにアプリを実行します。

node src/auth.js

📄 セキュリティ

• すべての機密認証情報は credentials ディレクトリに保存されます。
• OAuth 認証情報とトークンはバージョン管理対象外です。
• Google Drive への読み取り専用アクセスです。
• 安全な OAuth 2.0 認証フローを使用します。

🤝 コントリビューション

コントリビューションを歓迎します！ 自由に Pull Request を送信してください。

📝 ライセンス

この MCP サーバーは MIT ライセンスの下で配布されています。詳細は LICENSE ファイルを参照してください。

🔍 トラブルシューティング

問題が発生した場合：

1. Google Cloud プロジェクトの設定を確認します。
2. すべての必要な OAuth スコープが有効になっていることを確認します。
3. 認証情報が credentials ディレクトリに正しく配置されていることを確認します。
4. Google Drive 内のファイル権限とアクセス権限を確認します。

📚 ドキュメント

• Google Drive API ドキュメント
• OAuth 2.0 for Desktop Apps
• モデルコンテキストプロトコルドキュメント