Google Drive MCP Server

Servidor de Google Drive

Este servidor MCP se integra con Google Drive para permitir enumerar, 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, licenciado bajo la licencia MIT de este repositorio .

Componentes

Herramientas

• búsqueda en gdrive
  • Descripción : Busca archivos en Google Drive.
  • Aporte :
    • 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áximo 100).
  • Salida : Devuelve los nombres de archivos y los tipos MIME de los archivos coincidentes.
• archivo de lectura de gdrive
  • Descripción : Leer el contenido de un archivo de Google Drive.
  • Aporte :
    • fileId (cadena): ID del archivo a leer.
  • Salida : Devuelve el contenido del archivo especificado.
• gsheets_read
  • Descripción : Lea datos de una hoja de cálculo de Google con opciones flexibles de rangos y formato.
  • Aporte :
    • spreadsheetId (cadena): el ID de la hoja de cálculo que se leerá.
    • ranges (matriz de cadenas, opcional): Matriz opcional de rangos de notación A1 (p. ej., ['Sheet1!A1:B10'] ). Si no se proporciona, lee la hoja completa.
    • sheetId (número, opcional): ID de hoja específico para leer. Si no se proporcionan rangos, se lee la primera hoja.
  • Salida : Devuelve los datos especificados de la hoja de cálculo.
• celda de actualización de gsheets
  • Descripción : Actualizar un valor de celda en una hoja de cálculo de Google.
  • Aporte :
    • fileId (cadena): ID de la hoja de cálculo.
    • range (cadena): rango de celdas en notación A1 (por ejemplo, 'Sheet1!A1' ).
    • value (cadena): nuevo valor de celda.
  • Salida : Confirma el valor actualizado en la celda especificada.

Recursos

El servidor proporciona acceso a los archivos de Google Drive:

• Archivos ( gdrive:///<file_id> )
  • Admite todos los tipos de archivos
  • Los archivos de Google Workspace se exportan automáticamente:
    • Documentos → Markdown
    • Hojas de cálculo → CSV
    • Presentaciones → Texto sin formato
    • Dibujos → PNG
  • Otros archivos se proporcionan en su formato nativo.

Empezando

1. Crear un nuevo proyecto de Google Cloud
2. Habilitar la API de Google Drive
3. Configurar una pantalla de consentimiento de OAuth ("interna" es adecuada para realizar pruebas)
4. Agregar ámbitos OAuth https://www.googleapis.com/auth/drive.readonly , https://www.googleapis.com/auth/spreadsheets
5. Para permitir la interacción con hojas y documentos, también deberá habilitar la API de Google Sheets y la API de Google Docs en la sección API y servicios habilitados de sus espacios de trabajo.
6. Cree un ID de cliente OAuth para el tipo de aplicación "Aplicación de escritorio"
7. Descargue el archivo JSON de las claves OAuth de su cliente
8. Cambie el nombre del archivo de clave a gcp-oauth.keys.json y colóquelo en la ruta que especifique con GDRIVE_CREDS_DIR (es decir, /Users/username/.config/mcp-gdrive ).
9. Anote su ID de cliente de OAuth y su 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 y el secreto del cliente en la sección Credenciales de Google Cloud Console.

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 te solicitará que te autentiques con tu navegador. Debes autenticarte con una cuenta de la misma organización que tu 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:

Licencia

Este servidor MCP cuenta con la licencia MIT. Esto significa que puede usar, modificar y distribuir el software libremente, sujeto a los términos y condiciones de la licencia MIT. Para más detalles, consulte el archivo de LICENCIA en el repositorio del proyecto.