Google Drive MCP Server

Google Drive-Server

Dieser MCP-Server lässt sich in Google Drive integrieren, um das Auflisten, Lesen und Suchen von Dateien sowie das Lesen und Schreiben in Google Sheets zu ermöglichen.

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

Komponenten

Werkzeuge

• gdrive_search
  • Beschreibung : Suchen Sie in Google Drive nach Dateien.
  • Eingabe :
    • query (Zeichenfolge): Suchanfrage.
    • pageToken (Zeichenfolge, optional): Token für die nächste Ergebnisseite.
    • pageSize (Zahl, optional): Anzahl der Ergebnisse pro Seite (max. 100).
  • Ausgabe : Gibt Dateinamen und MIME-Typen passender Dateien zurück.
• gdrive_read_file
  • Beschreibung : Lesen Sie den Inhalt einer Datei von Google Drive.
  • Eingabe :
    • fileId (Zeichenfolge): ID der zu lesenden Datei.
  • Ausgabe : Gibt den Inhalt der angegebenen Datei zurück.
• gsheets_read
  • Beschreibung : Lesen Sie Daten aus einer Google-Tabelle mit flexiblen Optionen für Bereiche und Formatierung.
  • Eingabe :
    • spreadsheetId (Zeichenfolge): Die ID der zu lesenden Tabelle.
    • ranges (Array von Zeichenfolgen, optional): Optionales Array von A1-Notationsbereichen (z. B. ['Sheet1!A1:B10'] ). Wenn nicht angegeben, wird das gesamte Blatt gelesen.
    • sheetId (Zahl, optional): Spezifische Blatt-ID zum Lesen. Wenn keine Bereiche angegeben sind, wird das erste Blatt gelesen.
  • Ausgabe : Gibt die angegebenen Daten aus der Tabelle zurück.
• gsheets_update_cell
  • Beschreibung : Aktualisieren Sie einen Zellenwert in einer Google-Tabelle.
  • Eingabe :
    • fileId (Zeichenfolge): ID der Tabelle.
    • range (Zeichenfolge): Zellbereich in A1-Notation (z. 'Sheet1!A1' ).
    • value (Zeichenfolge): 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

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 zum Testen ausreichend)
4. OAuth-Bereiche hinzufügen https://www.googleapis.com/auth/drive.readonly , https://www.googleapis.com/auth/spreadsheets
5. Um die Interaktion mit Tabellen und Dokumenten zu ermöglichen, müssen Sie in Ihrem Arbeitsbereich im Abschnitt „Aktivierte API und Dienste“ auch die Google Sheets-API und die Google Docs-API 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 platzieren Sie sie in dem 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. Sie müssen zusammen mit Ihrem Konfigurationsverzeichnis als Umgebungsvariablen angegeben werden.
10. Sie müssen außerdem eine .env-Datei im Projekt mit den folgenden Feldern einrichten. Die Client-ID und das Client-Geheimnis finden Sie im Abschnitt „Anmeldeinformationen“ der Google Cloud Console.

Stellen Sie sicher, dass Sie den Server entweder mit 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 über Ihren 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 durch die Umgebungsvariable GDRIVE_CREDS_DIR angegebenen Verzeichnis gespeichert.

Verwendung mit der Desktop-App

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

Lizenz

Dieser MCP-Server ist unter der MIT-Lizenz lizenziert. Das bedeutet, dass Sie die Software unter den Bedingungen der MIT-Lizenz frei verwenden, ändern und verbreiten dürfen. Weitere Informationen finden Sie in der LICENSE-Datei im Projekt-Repository.