MCP 服务器

Google Docs, Drive & Sheets MCP Server

Enables deep integration with Google Workspace for AI assistants, allowing for document creation, spreadsheet manipulation, and file management. It supports advanced features like template processing, comment thread management, and cell formatting.

README

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
    }
  }
}