Servidor de Google Workspace de MCP

Un servidor de Protocolo de contexto de modelo (MCP) que permite que los agentes de IA interactúen con los servicios de Google Workspace (Drive, Docs y Sheets).

🌟 Características

• Google Drive: buscar archivos, crear carpetas

• Google Docs: crear, leer y actualizar documentos

• Hojas de cálculo de Google: crear hojas de cálculo, leer y escribir valores de celdas

• Múltiples modos de transporte: stdio (predeterminado), SSE, WebSocket

• Soporte de cliente compatible con MCP (Cursor, etc.)

Related MCP server: mcp-google-sheets

📋 Instalación

Uso de uv (recomendado)

Usando pip

Configuración de desarrollo

🔧 Configuración

Configurar para clientes MCP

Agregue a la configuración de su cliente (por ejemplo, Cursor, Claude):

Usando uvx (recomendado):

Usando la instalación de pip:

Configuración de Google OAuth

1. Visita la consola de Google Cloud

2. Habilitar las API de Drive, Docs y Sheets

3. Crear credenciales OAuth 2.0

4. Guardar como ~/.google/oauth.keys.json

5. Ejecute mcp-google auth para autenticarse

Herramientas disponibles

Operaciones de conducción

• drive_search_files : Buscar archivos en Google Drive

  • query (cadena, obligatoria): Consulta de búsqueda

  • page_size (entero, opcional): Número de resultados a devolver

• drive_create_folder : Crea una nueva carpeta

  • name (cadena, obligatorio): nombre de la carpeta

  • parent_id (cadena, opcional): ID de la carpeta principal

Operaciones de documentos

• docs_create : Crea un nuevo documento

  • title (cadena, obligatorio): Título del documento

  • content (cadena, opcional): contenido inicial

• docs_get_content : Obtener el contenido del documento

  • document_id (cadena, obligatoria): ID del documento

• docs_update_content : Actualizar el contenido del documento

  • document_id (cadena, obligatoria): ID del documento

  • content (cadena, obligatorio): Nuevo contenido

Operaciones con hojas de cálculo

• sheets_create : Crea una nueva hoja de cálculo

  • title (cadena, obligatorio): título de la hoja de cálculo

  • sheets (matriz, opcional): nombres de hojas

• sheets_get_values : Obtener valores de celda

  • spreadsheet_id (cadena, obligatoria): ID de la hoja de cálculo

  • range (cadena, obligatorio): rango de notación A1

• sheets_update_values : Actualizar valores de celda

  • spreadsheet_id (cadena, obligatoria): ID de la hoja de cálculo

  • range (cadena, obligatorio): rango de notación A1

  • values (matriz, obligatorio): matriz 2D de valores

🛠️ Desarrollo

🔍 Depuración

Utilice el Inspector MCP para realizar pruebas interactivas:

📚 Recursos

• Documentación

• Inspector de MCP

• Ganchos de pre-confirmación

• Consola de Google Cloud

🤝 Contribuyendo

Lea CONTRIBUTING.md para obtener detalles sobre nuestro código de conducta y el proceso para enviar solicitudes de extracción.

🔒 Seguridad

Consulte SECURITY.md para informar vulnerabilidades y mejores prácticas.

📄 Licencia

Licencia MIT: consulte el archivo LICENCIA para obtener más detalles.