Google Drive-Server

Dieser MCP-Server integriert sich in Google Drive, um das Auflisten, Lesen und Durchsuchen von Dateien sowie das Lesen und Schreiben in Google Tabellen zu ermöglichen.

Dieses Projekt enthält Code, der ursprünglich von Anthropic, PBC entwickelt und unter der MIT-Lizenz aus diesem Repository lizenziert wurde.

Komponenten

Werkzeuge

• gdrive_search

  • Beschreibung: Suche nach Dateien in Google Drive.

  • Eingabe:

    • query (string): Suchanfrage.

    • pageToken (string, optional): Token für die nächste Seite der Ergebnisse.

    • pageSize (number, optional): Anzahl der Ergebnisse pro Seite (max. 100).

  • Ausgabe: Gibt Dateinamen und MIME-Typen der übereinstimmenden Dateien zurück.

• gdrive_read_file

  • Beschreibung: Inhalt einer Datei aus Google Drive lesen.

  • Eingabe:

    • fileId (string): ID der zu lesenden Datei.

  • Ausgabe: Gibt den Inhalt der angegebenen Datei zurück.

• gsheets_read

  • Beschreibung: Daten aus einer Google Tabelle mit flexiblen Optionen für Bereiche und Formatierung lesen.

  • Eingabe:

    • spreadsheetId (string): Die ID der zu lesenden Tabelle.

    • ranges (array of strings, optional): Optionales Array von A1-Notationsbereichen (z.B. ['Sheet1!A1:B10']). Falls nicht angegeben, wird das gesamte Blatt gelesen.

    • sheetId (number, optional): Bestimmte Blatt-ID zum Lesen. Falls nicht zusammen mit ranges angegeben, wird das erste Blatt gelesen.

  • Ausgabe: Gibt die angegebenen Daten aus der Tabelle zurück.

• gsheets_update_cell

  • Beschreibung: Aktualisiert einen Zellenwert in einer Google Tabelle.

  • Eingabe:

    • fileId (string): ID der Tabelle.

    • range (string): Zellenbereich in A1-Notation (z.B. 'Sheet1!A1').

    • value (string): Neuer Zellenwert.

  • Ausgabe: Bestätigt den aktualisierten Wert in der angegebenen Zelle.

Ressourcen

Der Server bietet Zugriff auf Google Drive-Dateien:

• Dateien (gdrive:///<file_id>)

  • Unterstützt alle Dateitypen

  • Google Workspace-Dateien werden automatisch exportiert:

    • Dokumente → Markdown

    • Tabellen → CSV

    • Präsentationen → Klartext

    • Zeichnungen → PNG

  • Andere Dateien werden in ihrem nativen Format bereitgestellt

Related MCP server: Google Drive server

Erste Schritte

1. Erstellen Sie ein neues Google Cloud-Projekt

2. Aktivieren Sie die Google Drive API

3. Konfigurieren Sie einen OAuth-Zustimmungsbildschirm („intern“ ist für Tests in Ordnung)

4. Fügen Sie OAuth-Bereiche https://www.googleapis.com/auth/drive.readonly, https://www.googleapis.com/auth/spreadsheets hinzu

5. Um die Interaktion mit Tabellen und Dokumenten zu ermöglichen, müssen Sie auch die Google Sheets API und Google Docs API im Bereich „Aktivierte APIs und Dienste“ Ihres Workspace aktivieren.

6. Erstellen Sie eine OAuth-Client-ID für den Anwendungstyp „Desktop-App“

7. Laden Sie die JSON-Datei mit den OAuth-Schlüsseln Ihres Clients herunter

8. Benennen Sie die Schlüsseldatei in gcp-oauth.keys.json um und legen Sie sie in den Pfad, den Sie mit GDRIVE_CREDS_DIR angeben (z.B. /Users/username/.config/mcp-gdrive)

9. Notieren Sie Ihre OAuth-Client-ID und Ihr Client-Geheimnis. Diese müssen als Umgebungsvariablen zusammen mit Ihrem Konfigurationsverzeichnis angegeben werden.

10. Sie müssen auch eine .env-Datei im Projekt mit den folgenden Feldern einrichten. Die Client-ID und das Client-Geheimnis finden Sie im Bereich „Anmeldedaten“ der Google Cloud Console.

GDRIVE_CREDS_DIR=/path/to/config/directory
CLIENT_ID=<CLIENT_ID>
CLIENT_SECRET=<CLIENT_SECRET>

Stellen Sie sicher, dass Sie den Server mit entweder npm run build oder npm run watch erstellen.

Authentifizierung

Als nächstes müssen Sie node ./dist/index.js ausführen, um den Authentifizierungsschritt auszulösen

Sie werden aufgefordert, sich mit Ihrem Browser zu authentifizieren. Sie müssen sich mit einem Konto in derselben Organisation wie Ihr Google Cloud-Projekt authentifizieren.

Ihr OAuth-Token wird in dem von der Umgebungsvariablen GDRIVE_CREDS_DIR angegebenen Verzeichnis gespeichert.

Verwendung mit der Desktop-App

Um diesen Server in die Desktop-App zu integrieren, fügen Sie Folgendes zur Serverkonfiguration Ihrer App hinzu:

{
  "mcpServers": {
    "gdrive": {
      "command": "npx",
      "args": ["-y", "@isaacphi/mcp-gdrive"],
      "env": {
        "CLIENT_ID": "<CLIENT_ID>",
        "CLIENT_SECRET": "<CLIENT_SECRET>",
        "GDRIVE_CREDS_DIR": "/path/to/config/directory"
      }
    }
  }
}

Lizenz

Dieser MCP-Server ist unter der MIT-Lizenz lizenziert. Das bedeutet, dass Sie die Software frei nutzen, modifizieren und verbreiten können, vorbehaltlich der Bedingungen der MIT-Lizenz. Weitere Details finden Sie in der LICENSE-Datei im Projekt-Repository.