Drive File Browser MCP

Ein Model Context Protocol (MCP) Server, der KI-Assistenten — Claude Desktop, Claude Code, Cursor, opencode oder jeden MCP-Client — ermöglicht, einen Google Drive-Ordner zu durchsuchen, zu suchen und Dateien daraus zu lesen.

Läuft in zwei Modi:

• Lokal (stdio) — für Desktop-MCP-Clients

• Remote (HTTP, Streamable) — bereitgestellt auf Vercel: https://drive-file-browser-mcp.vercel.app/api/mcp

Bereitgestellte Tools

Related MCP server: mcp-google-gdrive

Remote-Bereitstellung (Vercel)

Der Server ist live unter:

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

Er verwendet den zustandslosen Streamable-HTTP-Transport und funktioniert daher mit jedem MCP-Client, der Remote-HTTP-Server unterstützt. Der Endpunkt ist mit einem Bearer-API-Schlüssel geschützt.

Einen Client verbinden

Claude Desktop / Claude Code (claude_desktop_config.json oder .mcp.json):

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

Beliebiger HTTP-Client — senden Sie JSON-RPC per POST mit den Headern Content-Type: application/json, Accept: application/json, text/event-stream, Authorization: Bearer <IHR_API_SCHLÜSSEL>:

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

Health-Check (ohne Authentifizierung): GET https://drive-file-browser-mcp.vercel.app/api/health

Eigene Instanz bereitstellen

1. Forken Sie dieses Repository, dann:

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. Besorgen Sie eine Google-Dienstkonto-JSON-Datei (siehe unten) und teilen Sie Ihren Drive-Ordner mit der zugehörigen client_email.

Umgebungsvariablen (Vercel)

Verwalten Sie sie im Vercel-Dashboard: Projekt → Einstellungen → Umgebungsvariablen.

Lokale Einrichtung (stdio-Modus)

1. Google-Dienstkonto erstellen

1. Gehen Sie zur Google Cloud Console und erstellen Sie ein Projekt (oder wählen Sie eines aus).

2. Aktivieren Sie die Google Drive API (APIs & Dienste → Bibliothek → nach „Google Drive API" suchen → Aktivieren).

3. Gehen Sie zu APIs & Dienste → Anmeldedaten → Anmeldedaten erstellen → Dienstkonto.

4. Öffnen Sie das Dienstkonto → Registerkarte Schlüssel → Neuen Schlüssel hinzufügen → Neuen Schlüssel erstellen → JSON. Eine .json-Schlüsseldatei wird heruntergeladen.

5. Teilen Sie den Drive-Ordner mit der E-Mail-Adresse des Dienstkontos (in der JSON-Datei als client_email zu finden, sieht aus wie xxx@xxx.iam.gserviceaccount.com) — klicken Sie im Drive mit der rechten Maustaste auf den Ordner → Freigeben → E-Mail-Adresse eingeben → Betrachter.

2. Installieren und erstellen

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

3. Konfigurieren

Legen Sie Umgebungsvariablen fest (oder kopieren Sie .env.example nach .env — beachten Sie: .env-Dateien werden NICHT automatisch geladen; setzen Sie echte Umgebungsvariablen in Ihrer MCP-Client-Konfiguration oder verweisen Sie mit GOOGLE_SERVICE_ACCOUNT_JSON auf einen Dateipfad):

Verwendung mit MCP-Clients

Fügen Sie die MCP-Konfiguration Ihres Clients hinzu:

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

Sobald die Verbindung hergestellt ist, können Sie Ihren Assistenten zum Beispiel bitten:

• „Liste die Dateien im Drive-Ordner auf"

• „Suche nach der Präsentation für die Pressekonferenz"

• „Lies die Unternehmenskommunikationsdatei"

• „Rufe Informationen zur Datei mit der ID ... ab"

Sicherheitshinweise

• Der Server verwendet den schreibgeschützten Drive-Bereich (drive.readonly).

• Committen Sie Ihren Dienstkontoschlüssel niemals. Er ist standardmäßig in .gitignore ausgeschlossen.

• Jeder, dem Sie die Schlüsseldatei geben, erhält Lesezugriff auf alles, was das Dienstkonto sehen kann — teilen Sie das Repository, nicht den Schlüssel.

Lizenz

MIT