Servidor Google Drive

Este servidor MCP s’integra amb Google Drive per permetre llistar, llegir i cercar fitxers, així com llegir i escriure a Google Sheets.

Aquest projecte inclou codi originalment desenvolupat per Anthropic, PBC, llicenciat sota la MIT License del repo.

Components

Eines

• gdrive_search

  • Description: Cerca fitxers a Google Drive.
  • Input:
    • query (string): Consulta de cerca.
    • pageToken (string, optional): Token per a la pàgina següent de resultats.
    • pageSize (number, optional): Nombre de resultats per pàgina (max 100).
  • Output: Retorna els noms de fitxers i tipus MIME dels fitxers que coincideixen.

• gdrive_read_file

  • Description: Llegeix el contingut d'un fitxer des de Google Drive.
  • Input:
    • fileId (string): ID del fitxer a llegir.
  • Output: Retorna el contingut del fitxer especificat.

• gsheets_read

  • Description: Llegeix dades d'un full de càlcul Google amb opcions flexibles per a rangs i format.
  • Input:
    • spreadsheetId (string): ID del full de càlcul a llegir.
    • ranges (array of strings, optional): Array opcional de rangs en notació A1 (p. ex. ['Sheet1!A1:B10']). Si no es proporciona, llegeix tot el full.
    • sheetId (number, optional): ID específic del full a llegir. Si no es proporciona amb rangs, llegeix el primer full.
  • Output: Retorna les dades especificades del full de càlcul.

• gsheets_update_cell

  • Description: Actualitza el valor d'una cel·la en un full de càlcul Google.
  • Input:
    • fileId (string): ID del full de càlcul.
    • range (string): Rango de cel·la en notació A1 (p. ex. 'Sheet1!A1').
    • value (string): Nou valor de la cel·la.
  • Output: Confirma el valor actualitzat a la cel·la especificada.

Recursos

El servidor proporciona accés als fitxers de Google Drive:

• Files (gdrive://<file_id>):
  • Suporta tots els tipus de fitxers.
  • Els fitxers de Google Workspace es converteixen automàticament:
    • Docs → Markdown
    • Sheets → CSV
    • Presentations → Plain text
    • Drawings → PNG
  • Altres fitxers es proporcionen en el seu format natiu.

Com començar

1. Crea un nou projecte de Google Cloud
2. Activa l'API de Google Drive
3. Configura una pantalla de consentiment OAuth ("internal" és adequat per a proves)
4. Afegeix els escopos OAuth https://www.googleapis.com/auth/drive.readonly, https://www.googleapis.com/auth/spreadsheets
5. Per permetre la interacció amb fulls i documents, també hauràs d'habilitar l'API de Google Sheets i l'API de Google Docs a la secció API i serveis habilitats del teu espai de treball.
6. Crea un ID de client OAuth per a l'aplicació de tipus "Desktop App"
7. Descarrega el fitxer JSON amb les claus OAuth del teu client
8. Canvia el nom del fitxer a gcp-oauth.keys.json i col·loca'l a la ruta que especifiquis amb GDRIVE_CREDS_DIR (p. ex. /Users/username/.config/mcp-gdrive)
9. Anota el teu ID de client OAuth i el secret del client. S'han d'especificar com a variables d'entorn junt amb el directori de configuració.
10. També hauràs de configurar un fitxer .env dins del projecte amb els següents camps. Pots trobar el Client ID i el Client Secret a la secció Credencials de la consola de Google Cloud.

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