Google ドライブ MCP サーバー

Google ドライブとのシームレスな統合を提供する強力なモデル コンテキスト プロトコル (MCP) サーバー。AI モデルが Google ドライブからファイルを検索、一覧表示、読み取ることができます。

🚀 機能

ツール

1. gdrive_search

強力な全文検索機能を使用して、Google ドライブ内のファイルを検索します。

• 入力:

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

• 出力: 次のファイルのリスト:

  • ファイル名

  • MIMEタイプ

  • ファイルID

  • 最終更新日時

  • ファイルサイズ

2. gdrive_read_file

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

• 入力:

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

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

自動ファイル形式処理

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

• 📝 Googleドキュメント → Markdown

• 📊 Google スプレッドシート → CSV

• 📊 Google プレゼンテーション → プレーンテキスト

• 🎨 Google 描画 → PNG

• 📄 テキスト/JSON ファイル → UTF-8 テキスト

• 📦 その他のファイル → Base64エンコード

Related MCP server: Google Drive MCP Server

🛠️ はじめに

前提条件

• Node.js (v16 以上)

• npmまたはyarn

• Google Cloud プロジェクト

• Google Workspace または個人の Google アカウント

Google Cloud の詳細な設定

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

   • Google Cloud Consoleにアクセスする

   • 「新しいプロジェクト」をクリックします

   • プロジェクト名を入力します（例：「MCP GDrive Server」）

   • 「作成」をクリック

   • プロジェクトが作成されるまで待って選択します

2. GoogleドライブAPIを有効にする

   • APIライブラリへ移動

   • 「Google Drive API」を検索

   • 「Google Drive API」をクリックします

   • 「有効にする」をクリックします

   • APIが有効になるまで待ちます

3. OAuth同意画面の設定

   • OAuth同意画面に移動する

   • ユーザータイプを選択:

     • Google Workspace を使用している場合は「内部」

     • 個人の Google アカウントの場合は「外部」

   • 「作成」をクリック

   • 必須フィールドに入力します。

     • アプリ名：「MCP GDrive Server」

     • ユーザーサポートメール: あなたのメールアドレス

     • 開発者連絡先メールアドレス: あなたのメールアドレス

   • 「保存して続行」をクリックします

   • 「スコープ」ページで：

     • 「スコープの追加または削除」をクリックします

     • https://www.googleapis.com/auth/drive.readonlyを追加します。

     • 「更新」をクリック

   • 「保存して続行」をクリックします

   • 概要を確認し、「ダッシュボードに戻る」をクリックします。

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

   • 資格情報へ移動

   • 上部の「認証情報を作成」をクリックします

   • 「OAuthクライアントID」を選択

   • アプリケーションの種類を選択：「デスクトップアプリ」

   • 名前:「MCP GDrive サーバー デスクトップ クライアント」

   • 「作成」をクリック

   • ポップアップで:

     • 「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 ドライブへの読み取り専用アクセス

• 安全なOAuth 2.0認証フロー

🤝 貢献する

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

📝 ライセンス

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

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

問題が発生した場合:

1. Google Cloud プロジェクトの設定を確認する

2. 必要なすべてのOAuthスコープが有効になっていることを確認する

3. 資格情報がcredentialsディレクトリに適切に配置されていることを確認します

4. Google ドライブのファイル権限とアクセス権を確認する

📚 追加リソース

• Google ドライブ API ドキュメント

• デスクトップアプリ向け OAuth 2.0

• モデルコンテキストプロトコルドキュメント