Google Drive server

お知らせ
この MCP サーバーは modelcontextprotocol/servers (src/gdrive) を基に、カスタマイズのための更新と変更を加えたものです。

この MCP サーバーは、modelcontextprotocol/servers (src/gdrive) を更新および変更したバージョンのリポジトリです。

---

---

---

Google Drive サーバー

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

コンポーネント

ツール

• search
  • Google Drive 内のファイルを検索します
  • 入力：query（文字列）：検索クエリ
  • 一致したファイルの名前と MIME タイプを返します

リソース

このサーバーから 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 を追加します
5. アプリケーションの種類を「Desktop App」にして、OAuth クライアント ID を作成します
6. クライアントの OAuth キーの JSON ファイルをダウンロードします
7. キーファイルの名前を gcp-oauth.keys.json に変更し、このリポジトリのルート（例：servers/gcp-oauth.keys.json）に配置します

npm run build または npm run watch でサーバーをビルドしてください。

認証

認証して認証情報を保存する手順は次のとおりです。

1. auth 引数を指定してサーバーを実行します：node ./dist auth
2. システムのブラウザーで認証フローが開きます
3. 認証手続きを完了します
4. 認証情報はこのリポジトリのルート（例：servers/.gdrive-server-credentials.json）に保存されます

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

このサーバーをデスクトップアプリと連携するには、アプリのサーバー設定に以下を追加します。

Docker

認証：

Google Cloud で OAuth アプリケーションの設定が完了している場合、次のコマンドでサーバーを認証できます。/path/to/gcp-oauth.keys.json は OAuth キーファイルへのパスに置き換えてください。

docker run -i --rm --mount type=bind,source=/path/to/gcp-oauth.keys.json,target=/gcp-oauth.keys.json -v mcp-gdrive:/gdrive-server -e GDRIVE_OAUTH_PATH=/gcp-oauth.keys.json -e "GDRIVE_CREDENTIALS_PATH=/gdrive-server/credentials.json" -p 3000:3000 mcp/gdrive auth

コマンドを実行すると、ブラウザーで開く URL が表示されます。この URL をブラウザーで開き、認証手続きを完了してください。認証情報は mcp-gdrive ボリュームに保存されます。

認証が完了すると、アプリのサーバー設定でサーバーを使用できます。

{
  "mcpServers": {
    "gdrive": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-v",
        "mcp-gdrive:/gdrive-server",
        "-e",
        "GDRIVE_CREDENTIALS_PATH=/gdrive-server/credentials.json",
        "mcp/gdrive"
      ]
    }
  }
}

NPX

{
  "mcpServers": {
    "gdrive": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-gdrive"]
    }
  }
}

VS Code での使用方法

すばやくインストールするには、以下のワンクリックインストールボタンのいずれかを使用してください。。

手動でインストールするには、以下の JSON ブロックを VS Code のユーザー設定（JSON）ファイルに追加します。Ctrl + Shift + P を押して Preferences: Open User Settings (JSON) と入力すると設定できます。

任意で、ワークスペース内の .vscode/mcp.json という名前のファイルに追加することもできます。これにより、設定を他のユーザーと共有できます。

.vscode/mcp.json ファイルでは、mcp キーは必要ありません。

NPX

{
  "mcp": {
    "servers": {
      "gdrive": {
        "command": "npx",
        "args": ["-y", "@modelcontextprotocol/server-gdrive"],
        "env": {
          "GDRIVE_CREDENTIALS_PATH": "/path/to/.gdrive-server-credentials.json"
        }
      }
    }
  }
}

Docker

{
  "mcp": {
    "servers": {
      "gdrive": {
        "command": "docker",
        "args": [
          "run",
          "-i",
          "--rm",
          "-v",
          "mcp-gdrive:/gdrive-server",
          "-e",
          "GDRIVE_CREDENTIALS_PATH=/gdrive-server/credentials.json",
          "mcp/gdrive"
        ]
      }
    }
  }
}

ライセンス

この MCP サーバーは MIT ライセンスのもとでライセンスされています。MIT ライセンスの利用規約に従うことを条件として、ソフトウェアを自由に使用、変更、配布できます。詳細については、プロジェクトリポジトリ内の LICENSE ファイルをご覧ください。