Servidor de Google Drive

Este servidor MCP se integra con Google Drive para permitir listar, leer y buscar archivos, así como la capacidad de leer y escribir en Google Sheets.

Este proyecto incluye código desarrollado originalmente por Anthropic, PBC, bajo la Licencia MIT de este repositorio.

Componentes

Herramientas

• gdrive_search

  • Descripción: Buscar archivos en Google Drive.

  • Entrada:

    • query (cadena): Consulta de búsqueda.

    • pageToken (cadena, opcional): Token para la siguiente página de resultados.

    • pageSize (número, opcional): Número de resultados por página (máx. 100).

  • Salida: Devuelve los nombres de archivo y tipos MIME de los archivos coincidentes.

• gdrive_read_file

  • Descripción: Leer el contenido de un archivo de Google Drive.

  • Entrada:

    • fileId (cadena): ID del archivo a leer.

  • Salida: Devuelve el contenido del archivo especificado.

• gsheets_read

  • Descripción: Leer datos de una hoja de cálculo de Google con opciones flexibles para rangos y formato.

  • Entrada:

    • spreadsheetId (cadena): El ID de la hoja de cálculo a leer.

    • ranges (matriz de cadenas, opcional): Matriz opcional de rangos en notación A1 (ej., ['Sheet1!A1:B10']). Si no se proporciona, lee toda la hoja.

    • sheetId (número, opcional): ID de hoja específico a leer. Si no se proporciona con rangos, lee la primera hoja.

  • Salida: Devuelve los datos especificados de la hoja de cálculo.

• gsheets_update_cell

  • Descripción: Actualizar el valor de una celda en una hoja de cálculo de Google.

  • Entrada:

    • fileId (cadena): ID de la hoja de cálculo.

    • range (cadena): Rango de celda en notación A1 (ej., 'Sheet1!A1').

    • value (cadena): Nuevo valor de la celda.

  • Salida: Confirma el valor actualizado en la celda especificada.

Recursos

El servidor proporciona acceso a archivos de Google Drive:

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

  • Soporta todos los tipos de archivo

  • Los archivos de Google Workspace se exportan automáticamente:

    • Documentos → Markdown

    • Hojas de cálculo → CSV

    • Presentaciones → Texto plano

    • Dibujos → PNG

  • Otros archivos se proporcionan en su formato nativo

Related MCP server: Google Drive server

Primeros pasos

1. Crear un nuevo proyecto de Google Cloud

2. Habilitar la API de Google Drive

3. Configurar una pantalla de consentimiento OAuth ("interna" es suficiente para pruebas)

4. Agregar los alcances OAuth https://www.googleapis.com/auth/drive.readonly, https://www.googleapis.com/auth/spreadsheets

5. Para permitir la interacción con hojas de cálculo y documentos, también deberá habilitar la API de Google Sheets y la API de Google Docs en la sección de APIs y Servicios Habilitados de su espacio de trabajo.

6. Crear un ID de cliente OAuth para el tipo de aplicación "Aplicación de escritorio"

7. Descargar el archivo JSON de las claves OAuth de su cliente

8. Renombrar el archivo de claves a gcp-oauth.keys.json y colocarlo en la ruta que especifique con GDRIVE_CREDS_DIR (ej., /Users/username/.config/mcp-gdrive)

9. Anotar su ID de cliente OAuth y Secreto de cliente. Deben proporcionarse como variables de entorno junto con su directorio de configuración.

10. También deberá configurar un archivo .env dentro del proyecto con los siguientes campos. Puede encontrar el ID de cliente y el Secreto de cliente en la sección Credenciales de la Consola de Google Cloud.

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

Asegúrese de construir el servidor con npm run build o npm run watch.

Autenticación

A continuación, deberá ejecutar node ./dist/index.js para activar el paso de autenticación

Se le pedirá que se autentique con su navegador. Debe autenticarse con una cuenta de la misma organización que su proyecto de Google Cloud.

Su token OAuth se guarda en el directorio especificado por la variable de entorno GDRIVE_CREDS_DIR.

Uso con la aplicación de escritorio

Para integrar este servidor con la aplicación de escritorio, agregue lo siguiente a la configuración del servidor de su aplicación:

{
  "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"
      }
    }
  }
}

Licencia

Este servidor MCP está licenciado bajo la Licencia MIT. Esto significa que es libre de usar, modificar y distribuir el software, sujeto a los términos y condiciones de la Licencia MIT. Para más detalles, consulte el archivo LICENSE en el repositorio del proyecto.