Google Docs MCP-Server

Dies ist ein Model Context Protocol (MCP)-Server, der Ihnen die Verbindung zu Google Docs über Claude ermöglicht. Mit diesem Server können Sie:

• Listen Sie alle Google Docs in Ihrem Drive auf

• Lesen Sie den Inhalt bestimmter Dokumente

• Neue Dokumente erstellen

• Vorhandene Dokumente aktualisieren

• Suche nach Dokumenten

• Dokumente löschen

Voraussetzungen

• Node.js v16.0.0 oder höher

• Google Cloud-Projekt mit aktivierter Google Docs API und Google Drive API

• OAuth 2.0-Anmeldeinformationen für Ihr Google Cloud-Projekt

Aufstellen

1. Klonen Sie dieses Repository und navigieren Sie zum Projektverzeichnis:

2. Installieren Sie Abhängigkeiten:

3. Erstellen Sie eine OAuth 2.0-Client-ID in der Google Cloud Console:

   • Gehen Sie zur Google Cloud Console

   • Erstellen Sie ein neues Projekt oder wählen Sie ein vorhandenes aus

   • Aktivieren Sie die Google Docs API und die Google Drive API

   • Gehen Sie zu „APIs & Dienste“ > „Anmeldeinformationen“

   • Klicken Sie auf „Anmeldeinformationen erstellen“ > „OAuth-Client-ID“.

   • Wählen Sie als Anwendungstyp „Desktop-App“ aus

   • Laden Sie die JSON-Datei herunter und speichern Sie sie als credentials.json in Ihrem Projektverzeichnis

   Wichtig : Die Dateien credentials.json und token.json enthalten vertrauliche Informationen und sind von der Versionskontrolle über .gitignore ausgeschlossen. Übertragen Sie diese Dateien niemals in Ihr Repository.

4. Erstellen Sie das Projekt:

5. Führen Sie den Server aus:

Wenn Sie den Server zum ersten Mal starten, werden Sie aufgefordert, sich bei Google zu authentifizieren. Folgen Sie den Anweisungen auf dem Bildschirm, um die Anwendung zu autorisieren. Dadurch wird eine token.json Datei generiert, in der Ihre Zugriffstoken gespeichert sind.

Sicherheitsüberlegungen

• Sicherheit der Anmeldeinformationen : Sowohl credentials.json als auch token.json enthalten vertrauliche Informationen und sollten niemals weitergegeben oder der Versionskontrolle übergeben werden. Sie sind bereits der .gitignore Datei hinzugefügt.

• Token-Aktualisierung : Die Anwendung aktualisiert das Zugriffstoken automatisch, wenn es abläuft.

• Zugriff widerrufen : Wenn Sie den Zugriff widerrufen müssen, löschen Sie die Datei token.json und gehen Sie zu den Sicherheitseinstellungen Ihres Google-Kontos, um die App aus Ihren autorisierten Anwendungen zu entfernen.

Verbindung zu Claude für Desktop herstellen

So verwenden Sie diesen Server mit Claude für Desktop:

1. Bearbeiten Sie Ihre Claude Desktop-Konfigurationsdatei:

   • Unter macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

   • Unter Windows: %APPDATA%\Claude\claude_desktop_config.json

2. Fügen Sie Ihrer Konfiguration Folgendes hinzu:

Ersetzen Sie /absolute/path/to/build/server.js durch den tatsächlichen Pfad zu Ihrer erstellten server.js-Datei.

3. Starten Sie Claude für Desktop neu.

Benutzeroberfläche

Der Google Docs MCP-Server verfügt über eine benutzerfreundliche Dialogschnittstelle, die:

• Präsentiert Dokumentinformationen in einem übersichtlichen, lesbaren Format

• Verwendet natürliche Sprachantworten anstelle von API-Rohdaten

• Formatiert Datumsangaben in einer für Menschen lesbaren Weise

• Stellt hilfreiche Folgefragen nach Aktionen bereit

• Gibt niemals vertrauliche Daten wie OAuth-Token preis

Dieses Schnittstellendesign ist so konzipiert, dass es zu anderen Claude MCP-Integrationen wie Notion passt und ein konsistentes und angenehmes Benutzererlebnis bietet.

Entwicklung

Projektstruktur

Neue Funktionen hinzufügen

So fügen Sie dem MCP-Server neue Funktionen hinzu:

1. Ändern Sie die Datei src/server.ts um neue Funktionen zu implementieren

2. Erstellen Sie das Projekt mit npm run build

3. Testen Sie Ihre Änderungen, indem Sie npm start ausführen

Verfügbare Ressourcen

• googledocs://list - Listet alle Google Docs in Ihrem Drive auf

• googledocs://{docId} – Ruft den Inhalt eines bestimmten Dokuments anhand der ID ab

Verfügbare Tools

• create-doc - Erstellt ein neues Google-Dokument mit dem angegebenen Titel und optionalem Inhalt

• update-doc – Aktualisiert ein vorhandenes Google-Dokument mit neuen Inhalten (anhängen oder ersetzen)

• insert-text - Fügt Text direkt in ein Dokument ein, ohne Notion oder andere Integrationen

• search-docs - Sucht nach Google Docs, die bestimmten Text enthalten

• delete-doc – Löscht ein Google-Dokument anhand der ID

Verfügbare Eingabeaufforderungen

• create-doc-template – Hilft beim Erstellen eines neuen Dokuments basierend auf einem bestimmten Thema und Schreibstil

• analyze-doc - Analysiert den Inhalt eines Dokuments und liefert eine Zusammenfassung

Anwendungsbeispiele

Hier sind einige Beispielaufforderungen, die Sie mit Claude verwenden können, sobald die Verbindung zum Server hergestellt ist:

• „Zeigen Sie mir eine Liste aller meiner Google Docs“

• „Erstellen Sie ein neues Google-Dokument mit dem Titel ‚Besprechungsnotizen‘ und dem Inhalt ‚Zu besprechende Themen: …‘“

• „Aktualisieren Sie mein Dokument mit der ID ‚1abc123def456‘, um diesen Abschnitt am Ende hinzuzufügen: …“

• „Durchsuchen Sie meine Google Docs nach Dokumenten, die ‚Projektvorschlag‘ enthalten.“

• „Löschen Sie das Google-Dokument mit der ID ‚1abc123def456‘“

• „Erstellen Sie ein formelles Dokument zum Klimawandel“

• „Analysieren Sie den Inhalt des Dokuments mit der ID ‚1abc123def456‘“

Fehlerbehebung

Wenn bei der Authentifizierung Probleme auftreten:

1. Löschen Sie die Datei token.json in Ihrem Projektverzeichnis

2. Führen Sie den Server erneut aus, um einen neuen Authentifizierungsablauf auszulösen

Wenn Sie Probleme mit der Google Docs-API haben:

1. Stellen Sie sicher, dass die API in Ihrer Google Cloud Console aktiviert ist

2. Überprüfen Sie, ob Ihre OAuth-Anmeldeinformationen die richtigen Bereiche haben

Beitragen

1. Forken Sie das Repository

2. Erstellen Sie einen Feature-Zweig: git checkout -b feature/your-feature-name

3. Übernehmen Sie Ihre Änderungen: git commit -am 'Add some feature'

4. Pushen zum Zweig: git push origin feature/your-feature-name

5. Senden einer Pull-Anfrage

Lizenz

MIT

Umgebungsvariablen

Erstellen Sie im Stammverzeichnis des Projekts eine .env Datei (oder exportieren Sie die Variablen in Ihrer Shell) mit den folgenden Schlüsseln:

Wenn diese Variablen festgelegt sind, versucht der Server nicht , credentials.json oder token.json von der Festplatte zu lesen.