Servidor MCP de Google Drive

Un potente servidor de Protocolo de contexto de modelo (MCP) que proporciona una integración perfecta con Google Drive, lo que permite que los modelos de IA busquen, enumeren y lean archivos de Google Drive.

🚀 Características

Herramientas

1. gdrive_search

Busque archivos en su Google Drive con potentes capacidades de búsqueda de texto completo.

• Aporte :
  { "query": "string (your search query)" }
• Salida : Lista de archivos con:
  • Nombre del archivo
  • Tipo MIME
  • ID de archivo
  • Hora de la última modificación
  • Tamaño del archivo

2. gdrive_read_file

Lea el contenido del archivo directamente usando un ID de archivo de Google Drive.

• Aporte :
  { "file_id": "string (Google Drive file ID)" }
• Salida : Contenido del archivo con la conversión de formato adecuada

Manejo automático de formatos de archivos

El servidor maneja de forma inteligente diferentes tipos de archivos de Google Workspace:

• 📝 Documentos de Google → Markdown
• Hojas de cálculo de Google → CSV
• Presentaciones de Google → Texto sin formato
• 🎨 Dibujos de Google → PNG
• 📄 Archivos de texto/JSON → Texto UTF-8
• 📦 Otros archivos → Codificado en Base64

🛠️ Primeros pasos

Prerrequisitos

• Node.js (v16 o superior)
• npm o hilo
• Un proyecto de Google Cloud
• Un espacio de trabajo de Google o una cuenta personal de Google

Configuración detallada de Google Cloud

1. Crear un proyecto de Google Cloud
   • Visita la consola de Google Cloud
   • Haga clic en "Nuevo proyecto"
   • Ingrese un nombre de proyecto (por ejemplo, "MCP GDrive Server")
   • Haga clic en "Crear"
   • Espere a que se cree el proyecto y selecciónelo
2. Habilitar la API de Google Drive
   • Ir a la biblioteca API
   • Buscar "API de Google Drive"
   • Haga clic en "API de Google Drive"
   • Haga clic en "Habilitar"
   • Espere a que se habilite la API
3. Configurar la pantalla de consentimiento de OAuth
   • Navegar a la pantalla de consentimiento de OAuth
   • Seleccionar tipo de usuario:
     • "Interno" si utilizas Google Workspace
     • "Externo" para cuentas personales de Google
   • Haga clic en "Crear"
   • Llene los campos obligatorios:
     • Nombre de la aplicación: "MCP GDrive Server"
     • Correo electrónico de soporte al usuario: su correo electrónico
     • Correo electrónico de contacto del desarrollador: su correo electrónico
   • Haga clic en "Guardar y continuar"
   • En la página "Ámbitos":
     • Haga clic en "Agregar o quitar ámbitos"
     • Agregue https://www.googleapis.com/auth/drive.readonly
     • Haga clic en "Actualizar"
   • Haga clic en "Guardar y continuar"
   • Revise el resumen y haga clic en "Volver al panel de control".
4. Crear ID de cliente OAuth
   • Ir a Credenciales
   • Haga clic en "Crear credenciales" en la parte superior
   • Seleccione "ID de cliente OAuth"
   • Seleccione el tipo de aplicación: "Aplicación de escritorio"
   • Nombre: "Cliente de escritorio del servidor MCP GDrive"
   • Haga clic en "Crear"
   • En la ventana emergente:
     • Haga clic en "Descargar JSON"
     • Guardar el archivo
     • Haga clic en "Aceptar"
5. Configurar credenciales en el proyecto
   # Create credentials directory mkdir credentials # Move and rename the downloaded JSON file mv path/to/downloaded/client_secret_*.json credentials/gcp-oauth.keys.json

Instalación

Autenticación

1. Crea un directorio de credenciales y coloca tus claves OAuth:
   mkdir credentials # Move your downloaded OAuth JSON file to the credentials directory as gcp-oauth.keys.json
2. Ejecute el comando de autenticación:
   node dist/index.js auth
3. Complete el flujo OAuth en su navegador
4. Las credenciales se guardarán en credentials/.gdrive-server-credentials.json

🔧 Uso

Como herramienta de línea de comandos

Integración con la aplicación de escritorio

Añade esta configuración a la configuración del servidor de tu aplicación:

Reemplace path/to/gdrive-mcp-server con la ruta real a su directorio de instalación.

Ejemplo de uso

1. Buscar archivos :
   // Search for documents containing "quarterly report" const result = await gdrive_search({ query: "quarterly report" });
2. Leer el contenido del archivo :
   // Read a specific file using its ID const contents = await gdrive_read_file({ file_id: "your-file-id" });

🔒 Seguridad

• Todas las credenciales confidenciales se almacenan en el directorio credentials
• Las credenciales y tokens de OAuth están excluidos del control de versiones
• Acceso de solo lectura a Google Drive
• Flujo de autenticación segura de OAuth 2.0

🤝 Contribuyendo

¡Agradecemos sus contribuciones! No dude en enviar una solicitud de incorporación de cambios.

📝 Licencia

Este servidor MCP está licenciado bajo la licencia MIT. Consulte el archivo de licencia para obtener más información.

🔍 Solución de problemas

Si encuentra problemas:

1. Verifique la configuración de su proyecto de Google Cloud
2. Asegúrese de que todos los ámbitos OAuth necesarios estén habilitados
3. Verifique que las credenciales estén colocadas correctamente en el directorio credentials
4. Verificar los permisos de archivos y los derechos de acceso en Google Drive

📚 Recursos adicionales

• Documentación de la API de Google Drive
• OAuth 2.0 para aplicaciones de escritorio
• Documentación del protocolo de contexto del modelo