Servidor MCP de Google Docs para Antigravity

Este repositorio contiene un servidor Model Context Protocol (MCP) especializado para una integración profunda con Google Docs, Drive y Sheets. Está optimizado para ser utilizado por asistentes de IA como Antigravity.

Características Principales

📄 Gestión de Google Docs

• Lectura y Escritura Avanzada: Lee y escribe documentos en formatos Texto, JSON o Markdown.

• Sistema de Comentarios: Gestión completa de hilos de comentarios (añadir, responder, resolver).

• Motor de Plantillas: Crea documentos a partir de plantillas con reemplazo dinámico de {{variables}}.

• Formateo de Estilos: Control total sobre estilos de texto (negrita, color, fuentes) y párrafos (encabezados, alineación).

• Inserción de Contenido: Inserta tablas, saltos de página e imágenes (locales o desde URL).

📁 Gestión de Google Drive

• Búsqueda Inteligente: Localiza archivos por nombre o contenido dentro de los documentos.

• Operaciones de Archivo: Mover, renombrar, copiar, eliminar y gestionar carpetas.

• Listado de Documentos: Filtra y lista tus documentos recientes o carpetas específicas.

📊 Gestión de Google Sheets

• Acceso a Datos: Lee y escribe en celdas y rangos usando notación A1.

• Formateo de Celdas: Aplica estilos visuales, colores de fondo y bordes.

• Gestión de Hojas: Crea, duplica, renombra o elimina pestañas dentro de un libro.

• Validaciones: Configura listas desplegables y congela filas/columnas.

Estructura del Proyecto

• src/: Código fuente en TypeScript del servidor MCP.

• SKILL_GENERIC.md: Archivo de "Skill" para Antigravity que documenta cómo utilizar este servidor de forma proactiva, incluyendo flujos ABM y prompts de diseño.

Configuración y Setup

1. Requisitos Previos

• Node.js instalado.

• Un proyecto en Google Cloud con las APIs de Google Docs, Google Drive y Google Sheets habilitadas.

• Credenciales OAuth 2.0 (tipo Desktop App) descargadas como credentials.json.

2. Instalación

Carga las dependencias y construye el proyecto:

npm install
npm run build

3. Autenticación

La primera vez que utilices el servidor (o mediante el comando auth si está disponible), se abrirá una ventana en tu navegador para autorizar el acceso a tu cuenta de Google.

node dist/index.js

El token de acceso se guardará en ~/.config/google-docs-mcp/token.json.

4. Configuración en Antigravity

Añade la configuración en tu archivo mcp_config.json:

{
  "mcpServers": {
    "google_docs": {
      "command": "node",
      "args": ["/ruta/absoluta/a/este/repo/dist/index.js"],
      "disabled": false
    }
  }
}

Uso con Antigravity

Una vez configurado, puedes añadir el contenido de SKILL_GENERIC.md a tu sistema de Skills globales para que el asistente pueda:

1. Generar reportes técnicos automáticos.

2. Sincronizar cambios entre código y documentación.

3. Crear presentaciones de proyectos con portadas generadas por IA.

Nota: Este servidor es una versión personalizada y optimizada basada en el trabajo original de a-bonus/google-docs-mcp.