Google Drive MCP Server

Google Drive MCP サーバー

Google Drive とのシームレスな連携を実現する強力な Model Context Protocol（MCP）サーバーです。AI モデルが Google Drive 内のファイルを検索、一覧表示、読み取りできるようにします。

🚀 機能

ツール

1. gdrive_search

高度な全文検索機能を使って、Google Drive 内のファイルを検索します。

• 入力:

  {
    "query": "string (your search query)"
  }
  

• 出力: 次の情報を含むファイルの一覧：
  • ファイル名
  • MIME タイプ
  • ファイル ID
  • 最終更新日時
  • ファイルサイズ

2. gdrive_read_file

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

• 入力:

  {
    "file_id": "string (Google Drive file ID)"
  }
  

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

ファイル形式の自動処理

このサーバーは、さまざまな Google Workspace ファイル形式をインテリジェントに処理します：

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

🛠️ はじめに

前提条件

• Node.js（v16 以降）
• npm または yarn
• Google Cloud プロジェクト
• Google Workspace アカウントまたは個人の Google アカウント

Google Cloud の詳細な設定

1. Google Cloud プロジェクトを作成する

   • Google Cloud Console にアクセスします
   • 「New Project」をクリックします
   • プロジェクト名を入力します（例：「MCP GDrive Server」）
   • 「Create」をクリックします
   • プロジェクトが作成されるまで待ち、作成したプロジェクトを選択します

2. Google Drive API を有効にする

   • API Library に移動します
   • 「Google Drive API」を検索します
   • 「Google Drive API」をクリックします
   • 「Enable」をクリックします
   • API が有効になるまで待ちます

3. OAuth 同意画面を設定する

   • OAuth consent screen に移動します
   • ユーザータイプを選択します：
     • Google Workspace を使用している場合は「Internal」
     • 個人の Google アカウントの場合は「External」
   • 「Create」をクリックします
   • 必須項目を入力します：
     • アプリ名：「MCP GDrive Server」
     • ユーザーサポートのメールアドレス：ご自身のメールアドレス
     • デベロッパーの連絡先メールアドレス：ご自身のメールアドレス
   • 「Save and Continue」をクリックします
   • 「Scopes」ページで：
     • 「Add or Remove Scopes」をクリックします
     • https://www.googleapis.com/auth/drive.readonly を追加します
     • 「Update」をクリックします
   • 「Save and Continue」をクリックします
   • 概要を確認し、「Back to Dashboard」をクリックします

4. OAuth クライアント ID を作成する

   • Credentials に移動します
   • 上部の「Create Credentials」をクリックします
   • 「OAuth client ID」を選択します
   • アプリケーションの種類として「Desktop app」を選択します
   • 名前：「MCP GDrive Server Desktop Client」
   • 「Create」をクリックします
   • ポップアップで：
     • 「Download JSON」をクリックします
     • ファイルを保存します
     • 「OK」をクリックします

5. プロジェクトに認証情報を設定する

   # Create credentials directory
   mkdir credentials
   
   # Move and rename the downloaded JSON file
   mv path/to/downloaded/client_secret_*.json credentials/gcp-oauth.keys.json
   

インストール

# Clone the repository
git clone https://github.com/felores/gdrive-mcp-server.git
cd gdrive-mcp-server

# Install dependencies
npm install

# Build the project
npm run build

認証

1. 認証情報用のディレクトリを作成し、OAuth キーを配置します：

   mkdir credentials
   # Move your downloaded OAuth JSON file to the credentials directory as gcp-oauth.keys.json
   

2. 認証コマンドを実行します：

   node dist/index.js auth
   

3. ブラウザーで OAuth フローを完了します

4. 認証情報は credentials/.gdrive-server-credentials.json に保存されます

🔧 使い方

コマンドラインツールとして

# Start the server
node dist/index.js

デスクトップアプリとの連携

この設定をアプリのサーバー設定に追加します：

{
  "mcpServers": {
    "gdrive": {
      "command": "node",
      "args": ["path/to/gdrive-mcp-server/dist/index.js"],
      "env": {
        "GOOGLE_APPLICATION_CREDENTIALS": "path/to/gdrive-mcp-server/credentials/gcp-oauth.keys.json",
        "MCP_GDRIVE_CREDENTIALS": "path/to/gdrive-mcp-server/credentials/.gdrive-server-credentials.json"
      }
    }
  }
}

path/to/gdrive-mcp-server を、インストールディレクトリの実際のパスに置き換えてください。

使用例

1. ファイルを検索する：

   // Search for documents containing "quarterly report"
   const result = await gdrive_search({ query: "quarterly report" });
   

2. ファイルの内容を読み取る：

   // Read a specific file using its ID
   const contents = await gdrive_read_file({ file_id: "your-file-id" });
   

🔒 セキュリティ

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

🤝 貢献

貢献を歓迎します！お気軽にプルリクエストを送信してください。

📝 ライセンス

この MCP サーバーは MIT License の下でライセンスされています。詳細は LICENSE ファイルをご覧ください。

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

問題が発生した場合：

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

📚 追加リソース

• Google Drive API ドキュメント
• デスクトップアプリ向け OAuth 2.0
• Model Context Protocol ドキュメント