Integración de Google Workspace con MCP
Una herramienta integral MCP (Protocolo de control de Metaro) para interactuar con los servicios de Google Workspace, incluidos Google Docs, Sheets, Slides y Drive.
Características
Funciones de Google Drive
- Lista de archivos
- Copiar archivos
- Cambiar el nombre de los archivos
- Crear hojas de cálculo vacías
- Crear hojas de cálculo a partir de plantillas
- Copiar hojas de cálculo existentes
Funciones de Hojas de cálculo de Google
- Hojas de lista
- Copiar hojas
- Cambiar el nombre de las hojas
- Obtener datos de la hoja
- Agregar/Eliminar filas
- Agregar/Eliminar columnas
- Actualizar celdas
- Crear/Actualizar/Eliminar gráficos
- Actualizar formatos de celda
Funciones de Google Docs
- Crear documentos
- Insertar texto con formato
- Añadir encabezados
- Insertar imágenes
- Crear y administrar tablas
- Insertar saltos de página
- Añadir reglas horizontales
- Actualizar estilos de documentos
- Administrar estilos y contenido de tablas
Funciones de Presentaciones de Google
- Crear presentaciones
- Agregar diapositivas
- Insertar imágenes
- Añadir formas y líneas
- Actualizar estilos de texto
- Modificar los fondos de las diapositivas
- Actualizar diseños de diapositivas
- Agregar transiciones de diapositivas
- Agregar notas del orador
Instalación
1. Configuración del entorno virtual
macOS/Linux
# Create virtual environment
python -m venv venv
# Activate virtual environment
source venv/bin/activate
Ventanas
# Create virtual environment
python -m venv venv
# Activate virtual environment
venv\Scripts\activate
2. Instalar los paquetes necesarios
pip install -r requirements.txt
3. Configuración de la consola de Google Cloud
- Crear un proyecto en Google Cloud Console
- Crear ID de cliente OAuth 2.0
- Habilitar las API requeridas:
- API de Hojas de cálculo de Google
- API de Google Drive
- API de Google Docs
- API de Presentaciones de Google
4. Configuración de variables de entorno
export MCPGD_CLIENT_SECRET_PATH="/path/to/client_secret.json"
export MCPGD_FOLDER_ID="your_folder_id"
export MCPGD_TOKEN_PATH="/path/to/token.json" # Optional
Uso
1. Ejecute el programa
2. Utilizar herramientas a través de MCP
Ejemplos de Google Drive
# List files
mcp list_files
# Copy a file
mcp copy_file --file-id "file_id" --new_name "new_name"
Ejemplos de Hojas de cálculo de Google
# Get sheet data
mcp get_sheet_data --spreadsheet_id "your_spreadsheet_id" --range "Sheet1!A1:D10"
# Create chart
mcp create_chart --chart_type "LINE" --range "A1:B10" --sheet_name "Sheet1" --title "Sales Trend"
Ejemplos de Google Docs
# Create document
mcp create_document --title "My Document"
# Insert formatted text
mcp insert_text_to_document --document_id "doc_id" --text "Hello World" --font_family "Arial" --font_size 12
Ejemplos de Presentaciones de Google
# Create presentation
mcp create_presentation --title "My Presentation"
# Add slide with content
mcp add_slide_to_presentation --presentation_id "presentation_id" --title "Slide Title" --content "Slide Content"
Variables de entorno
MCPGD_CLIENT_SECRET_PATH
: Ruta al archivo secreto del cliente de Google OAuth 2.0MCPGD_FOLDER_ID
: ID de la carpeta de Google DriveMCPGD_TOKEN_PATH
: Ruta al archivo de almacenamiento de tokens (opcional, predeterminado: ~/.mcp_google_spreadsheet.json)
Licencia
Licencia MIT