Google Drive server

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"
      ]
    }
  }
}

ライセンス

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