Google Drive サーバー

この MCP サーバーは Google Drive と連携し、ファイルの一覧表示、読み取り、検索、さらに Google Sheets の読み書きを可能にします。

このプロジェクトには、Anthropic, PBC が当初開発したコードが含まれており、このリポジトリ から MIT ライセンスのもとで提供されています。

コンポーネント

ツール

• gdrive_search

  • 説明: Google Drive 内のファイルを検索します。

  • 入力:

    • query (string): 検索クエリ。

    • pageToken (string, オプション): 次の結果ページのトークン。

    • pageSize (number, オプション): 1ページあたりの結果数 (最大 100)。

  • 出力: 一致したファイルのファイル名と MIME タイプを返します。

• gdrive_read_file

  • 説明: Google Drive からファイルの内容を読み取ります。

  • 入力:

    • fileId (string): 読み取るファイルの ID。

  • 出力: 指定されたファイルの内容を返します。

• gsheets_read

  • 説明: 柔軟な範囲指定と書式設定オプションを使用して Google スプレッドシートからデータを読み取ります。

  • 入力:

    • spreadsheetId (string): 読み取るスプレッドシートの ID。

    • ranges (string の配列, オプション): A1 記法の範囲のオプションの配列 (例: ['Sheet1!A1:B10'])。指定しない場合はシート全体を読み取ります。

    • sheetId (number, オプション): 読み取る特定のシート ID。ranges とともに指定しない場合は最初のシートを読み取ります。

  • 出力: スプレッドシートから指定されたデータを返します。

• gsheets_update_cell

  • 説明: Google スプレッドシートのセル値を更新します。

  • 入力:

    • fileId (string): スプレッドシートの ID。

    • range (string): A1 記法のセル範囲 (例: 'Sheet1!A1')。

    • value (string): 新しいセル値。

  • 出力: 指定されたセルで更新された値を確認します。

リソース

サーバーは Google Drive ファイルへのアクセスを提供します：

• ファイル (gdrive:///<file_id>)

  • すべてのファイルタイプをサポート

  • Google Workspace ファイルは自動的にエクスポートされます：

    • ドキュメント → Markdown

    • シート → CSV

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

    • 図形描画 → PNG

  • その他のファイルはネイティブ形式で提供されます

Related MCP server: Google Drive server

はじめに

1. 新しい Google Cloud プロジェクトを作成 します

2. Google Drive API を有効化 します

3. OAuth 同意画面を構成 します（テスト用途では「内部」で問題ありません）

4. OAuth スコープ https://www.googleapis.com/auth/drive.readonly、https://www.googleapis.com/auth/spreadsheets を追加します

5. シートやドキュメントとのやり取りを可能にするには、ワークスペースの「有効な API とサービス」セクションで Google Sheets API と Google Docs API も有効にする必要があります。

6. アプリケーションタイプ「デスクトップアプリ」用に OAuth クライアント ID を作成 します

7. クライアントの OAuth キーの JSON ファイルをダウンロードします

8. キーファイルの名前を gcp-oauth.keys.json に変更し、GDRIVE_CREDS_DIR で指定したパス（例：/Users/username/.config/mcp-gdrive）に配置します

9. OAuth クライアント ID とクライアントシークレットをメモします。これらは、設定ディレクトリとともに環境変数として指定する必要があります。

10. プロジェクト内に .env ファイ ルを設定し、次のフ ィールドを記入する必 要もあります。ク ライアント ID とク ライアントシークレットは Google Cloud コンソールの「認証情報」セクションで確認できます。

GDRIVE_CREDS_DIR=/path/to/config/directory
CLIENT_ID=<CLIENT_ID>
CLIENT_SECRET=<CLIENT_SECRET>

サーバーをビルドするには、npm run build または npm run watch を実行してください。

認証

次に、node ./dist/index.js を実行して認証手順を開始する必要があります。

ブラウザで認証を求められます。Google Cloud プロジェクトと同じ組織のアカウントで認証する必要があります。

OAuth トークンは GDRIVE_CREDS_DIR 環境変数で指定されたディレクトリに保存されます。

デスクトップアプリでの使用

このサーバーをデスクトップアプリに統合するには、アプリのサーバー設定に以下を追加します：

{
  "mcpServers": {
    "gdrive": {
      "command": "npx",
      "args": ["-y", "@isaacphi/mcp-gdrive"],
      "env": {
        "CLIENT_ID": "<CLIENT_ID>",
        "CLIENT_SECRET": "<CLIENT_SECRET>",
        "GDRIVE_CREDS_DIR": "/path/to/config/directory"
      }
    }
  }
}

ライセンス

この MCP サーバーは MIT ライセンスのもとで提供されています。これは、MIT ライセンスの条件に従って、ソフトウェアを自由に使用、変更、配布できることを意味します。詳細については、プロジェクトリポジトリの LICENSE ファイルを参照してください。