gdrive-mcp

Ein MCP-Server (Model Context Protocol), der einen Google-Drive-Ordner über Streamable HTTP verfügbar macht, für den Betrieb auf Vercel erstellt wurde und auf GitHub gehostet wird.

Er stellt zwei Tools bereit:

Architektur

• server.ts – Node.js-HTTP-Server-Einstiegspunkt (Streamable-HTTP-MCP-Endpunkt).

• src/mcp.ts – MCP-Server-Definition + Tools.

• src/drive.ts – Google-Drive-Client mit einem Dienstkonto.

Die Authentifizierung erfolgt schreibgeschützt (drive.readonly) über ein Google-Dienstkonto.

Related MCP server: gdrive-mcp-server

1. Einrichtung von Google Cloud (Dienstkonto)

1. Gehen Sie zur Google Cloud Console und erstellen Sie ein Projekt.

2. Aktivieren Sie die Google Drive API: APIs & Services → Library → Suchen Sie nach "Google Drive API" → Enable.

3. Erstellen Sie ein Dienstkonto: IAM & Admin → Service Accounts → Create Service Account.

4. Erstellen Sie einen JSON-Schlüssel dafür: Öffnen Sie das Dienstkonto → Keys → Add Key → Create New Key → JSON. Laden Sie die Datei herunter.

5. Notieren Sie die E-Mail-Adresse des Dienstkontos (sieht aus wie name@project.iam.gserviceaccount.com).

6. Teilen Sie den Drive-Ordner mit dieser E-Mail-Adresse:

   • Öffnen Sie Ihren Ordner in Google Drive → Rechtsklick → Share.

   • Fügen Sie die E-Mail-Adresse des Dienstkontos ein und geben Sie Viewer-Zugriff.

7. Kopieren Sie die Ordner-ID (den Teil nach /folders/ in der URL).

2. Lokale Einrichtung

git clone <your-repo-url>
cd gdrive-mcp
npm install

Erstellen Sie eine .env-Datei (kopieren Sie .env.example):

DRIVE_FOLDER_ID=1XM-0CtgvW3PGDekC8qLa2ghxRyvTfjwD
GOOGLE_SERVICE_ACCOUNT_KEY=<base64 of service-account.json>

Kodieren Sie den Dienstkonto-Schlüssel in Base64:

• Linux/macOS: base64 -w0 service-account.json

• PowerShell: [Convert]::ToBase64String([IO.File]::ReadAllBytes("service-account.json"))

3. Auf Vercel bereitstellen

Option A – Vercel + GitHub (empfohlen)

1. Pushen Sie dieses Repository.

2. In Vercel → Add New Project → importieren Sie das GitHub-Repository. Öffnen Sie Vercel → Add New Project → Importieren Sie das GitHub-Repository.

3. Fügen Sie die Umgebungsvariablen hinzu (DRIVE_FOLDER_ID, GOOGLE_SERVICE_ACCOUNT_KEY).

4. Deployen. Der MCP-Endpunkt wird sein:

   https://<your-project>.vercel.app

Option B – Vercel CLI

npm i -g vercel
vercel login
vercel env add DRIVE_FOLDER_ID
vercel env add GOOGLE_SERVICE_ACCOUNT_KEY
vercel --prod

4. Auf GitHub puschen (erster Start)

git init
git add .
git commit -m "Add gdrive-mcp server"
git branch -M main
git remote add origin https://github.com/<you>/gdrive-mcp.git
git push -u origin main

5. MCP-Client verbinden

Verbinden Sie Ihren Client über den Streamable HTTP-Transport mit der bereitgestellten URL. Beispiel claude_desktop_config.json:

{
  "mcpServers": {
    "gdrive": {
      "type": "http",
      "url": "https://<your-project>.vercel.app"
    }
  }
}

Für Clients, die das allgemeine MCP-Konfigurationsformat verwenden:

{
  "mcpServers": {
    "gdrive": {
      "url": "https://<your-project>.vercel.app"
    }
  }
}

Der Endpunkt ist zustandslos, daher erzeugt jede Anfrage einen neuen Transport – ideal für serverless. Der Zugriff wird über die Google-Drive-Freigabe des Dienstkontos gesteuert.

Umgebungsvariablen