Drive File Browser MCP

AIアシスタント（Claude Desktop、Claude Code、Cursor、opencode、または任意のMCPクライアント）がGoogle Driveフォルダ内のファイルを閲覧、検索、読み取りできるようにするModel Context Protocol（MCP）サーバーです。

2つのモードで実行できます：

• ローカル（stdio） — デスクトップMCPクライアント向け

• リモート（HTTP、Streamable） — Vercelにデプロイ：https://drive-file-browser-mcp.vercel.app/api/mcp

提供ツール

Related MCP server: mcp-google-gdrive

リモートデプロイ（Vercel）

サーバーは以下で稼働中です：

https://drive-file-browser-mcp.vercel.app/api/mcp

ステートレスなStreamable HTTPトランスポートを使用するため、リモートHTTP MCPサーバーをサポートする任意のMCPクライアントで動作します。エンドポイントはBearer APIキーで保護されています。

クライアントの接続

Claude Desktop / Claude Code（claude_desktop_config.json または .mcp.json）：

{
  "mcpServers": {
    "drive-browser": {
      "type": "http",
      "url": "https://drive-file-browser-mcp.vercel.app/api/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_API_KEY>"
      }
    }
  }
}

任意のHTTPクライアント — ヘッダー Content-Type: application/json、Accept: application/json, text/event-stream、Authorization: Bearer <YOUR_API_KEY> を使用してJSON-RPCをPOST送信：

curl -X POST https://drive-file-browser-mcp.vercel.app/api/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "Authorization: Bearer <YOUR_API_KEY>" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"curl","version":"1.0"}}}'

ヘルスチェック（認証不要）：GET https://drive-file-browser-mcp.vercel.app/api/health

独自インスタンスのデプロイ

1. このリポジトリをフォーク/クローンし、以下の手順を実行：

npm install
npm i -g vercel
vercel login
vercel link --yes
# env vars:
echo "<your-api-key>" | vercel env add MCP_API_KEY production
echo "<your-drive-folder-id>" | vercel env add DRIVE_ROOT_FOLDER_ID production
echo "<service-account-json-contents>" | vercel env add GOOGLE_SERVICE_ACCOUNT_JSON production
vercel deploy --prod --yes

2. GoogleサービスアカウントのJSONを取得し（下記参照）、そのclient_emailでDriveフォルダを共有します。

環境変数（Vercel）

これらはVercelダッシュボードの「Project → Settings → Environment Variables」で管理します。

ローカルセットアップ（stdioモード）

1. Googleサービスアカウントの作成

1. Google Cloud Consoleにアクセスし、プロジェクトを作成（または選択）します。

2. Google Drive APIを有効にします（APIs & Services → Library → 「Google Drive API」を検索 → Enable）。

3. APIs & Services → Credentials → Create Credentials → Service accountの順に進みます。

4. サービスアカウントを開き、Keysタブ → Add key → Create new key → JSONを選択します。.jsonキーファイルがダウンロードされます。

5. Driveフォルダをサービスアカウントのメールアドレスと共有します（メールアドレスはJSONファイル内のclient_emailフィールドに記載。例：xxx@xxx.iam.gserviceaccount.com）— Driveでフォルダを右クリック → Share → そのメールアドレスを入力 → Viewer権限を付与。

2. インストールとビルド

git clone https://github.com/ashrafur02-sys/drive-file-browser-mcp.git
cd drive-file-browser-mcp
npm install
npm run build

3. 設定

環境変数を設定します（.env.exampleを.envにコピー — 注：.envファイルは自動読み込まれません。MCPクライアント設定で実際の環境変数を設定するか、GOOGLE_SERVICE_ACCOUNT_JSONをファイルパスに指定してください）：

MCPクライアントでの使用方法

MCPクライアントの設定に追加します：

Claude Desktop（claude_desktop_config.json）：

{
  "mcpServers": {
    "drive-browser": {
      "command": "node",
      "args": ["/absolute/path/to/drive-file-browser-mcp/dist/src/index.js"],
      "env": {
        "GOOGLE_SERVICE_ACCOUNT_JSON": "/absolute/path/to/service-account.json",
        "DRIVE_ROOT_FOLDER_ID": "1TG4ssc_z0FgG2snDapoR_SRu3y16Wxm5"
      }
    }
  }
}

Claude Code / opencode：

{
  "mcpServers": {
    "drive-browser": {
      "type": "stdio",
      "command": "node",
      "args": ["/absolute/path/to/drive-file-browser-mcp/dist/src/index.js"],
      "env": {
        "GOOGLE_SERVICE_ACCOUNT_JSON": "/absolute/path/to/service-account.json",
        "DRIVE_ROOT_FOLDER_ID": "1TG4ssc_z0FgG2snDapoR_SRu3y16Wxm5"
      }
    }
  }
}

接続後、アシスタントに次のようなリクエストができます：

• 「Driveフォルダ内のファイルを一覧表示して」

• 「記者会見のプレゼンテーションを検索して」

• 「社内コミュニケーションファイルを読んで」

• 「IDが...のファイルの情報を取得して」

セキュリティに関する注意事項

• サーバーは読み取り専用のDriveスコープ（drive.readonly）を使用します。

• サービスアカウントキーをリポジトリにコミットしないでください（.gitignoreで除外済み）。

• キーファイルを共有した相手は、サービスアカウントがアクセスできるすべての情報を読み取れることに注意してください。リポジトリではなく、キーを共有しましょう。

ライセンス

MIT