# 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:
```bash
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.
```bash
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`:

```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](https://github.com/a-bonus/google-docs-mcp).*