Google Drive server

Google Drive サーバー

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

このプロジェクトには、Anthropic, PBC が開発したコードが含まれており、このリポジトリ の MIT License に基づいてライセンスされています。

コンポーネント

ツール

• 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（文字列の配列、任意）：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 ファイルは自動的にエクスポートされます：
    • Docs → Markdown
    • Sheets → CSV
    • Presentations → プレーンテキスト
    • Drawings → PNG
  • その他のファイルはネイティブ形式で提供されます

はじめに

1. 新しい Google Cloud プロジェクトを作成します
2. Google Drive API を有効にします
3. OAuth 同意画面を設定します（テストでは「internal」で問題ありません）
4. OAuth スコープ https://www.googleapis.com/auth/drive.readonly、https://www.googleapis.com/auth/spreadsheets を追加します
5. Sheets と Docs とのやり取りを可能にするには、ワークスペースの「Enabled API and Services」セクションで Google Sheets API と Google Docs API も有効にする必要があります。
6. アプリケーションの種類を「Desktop App」として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 Console の「Credentials」セクションで確認できます。

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 ファイルをご覧ください。