Servidor 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, licenciado bajo la Licencia MIT desde este repo.

Componentes

Herramientas

• gdrive_buscar

  • Descripción: Búsqueda de 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áximo 100).
  • Resultados: Devuelve los nombres de archivo y los tipos MIME de los archivos coincidentes.

• gdrive_leer_archivo

  • Descripción: Lee el contenido de un archivo de Google Drive.
  • Entrada
    • fileId (cadena): ID del archivo a leer.
  • Salida: Devuelve el contenido del fichero especificado.

• gsheets_read

  • Descripción: Lee 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 (array de cadenas, opcional): Matriz opcional de rangos en notación A1 (por ejemplo, ['Hoja1!A1:B10']). Si no se proporciona, se 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: Actualiza 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 celdas en notación A1 (por ejemplo, 'Hoja1!A1').
    • value (cadena): Valor de la nueva 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 → CSV
    • Presentaciones → Texto sin formato
    • Dibujos → PNG
  • Otros archivos se proporcionan en su formato nativo

Cómo empezar

1. Crear un nuevo proyecto de Google Cloud
2. Habilitar la API de Google Drive
3. Configurar una pantalla de consentimiento OAuth ("interna" está bien para las pruebas)
4. Añade los ámbitos de 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ás habilitar la API deGoogle Sheets y la API de Google Docs en la sección API y servicios habilitados de tu espacio de trabajo.
6. Crea un ID de cliente OAuth para el tipo de aplicación "Desktop App"
7. Descarga el archivo JSON de las claves OAuth de tu cliente
8. Cambia el nombre del archivo de claves a gcp-oauth.keys.json y colócalo en la ruta que especifiques con GDRIVE_CREDS_DIR (es decir, /Usuarios/nombredeusuario/.config/mcp-gdrive)
9. Tenga en cuenta su OAuth Client ID y Client Secret. Deben proporcionarse como variables de entorno junto con su directorio de configuración.
10. También necesitarás 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 tendrás que ejecutar node ./dist/index.js para activar el paso de autenticación

Se te pedirá que te autentiques con tu navegador. Debes autenticarte con una cuenta de la misma organización que tu proyecto de Google Cloud.

Tu 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 app de escritorio, añade lo siguiente a la configuración del servidor de tu app:

{ "mcpServers": { "gdrive": { "command": "npx", "args": ["-y", "@isaacphi/mcp-gdrive"], "env": {"CLIENT_ID": "<ID_CLIENTE>", "SECRETO_CLIENTE": "<CLIENT_SECRET>", "GDRIVE_CREDS_DIR": "/ruta/a/config/directorio" } } }

Licencia

Este servidor MCP está licenciado bajo la Licencia MIT. Esto significa que usted 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.