Servidor MCP de Google Docs

Este es un servidor de Protocolo de Contexto de Modelo (MCP) que te permite conectarte a Google Docs a través de Claude. Con este servidor, puedes:

• Lista todos los documentos de Google Docs en tu Drive

• Leer el contenido de documentos específicos

• Crear nuevos documentos

• Actualizar documentos existentes

• Buscar documentos

• Eliminar documentos

Prerrequisitos

• Node.js v16.0.0 o posterior

• Proyecto de Google Cloud con la API de Google Docs y la API de Google Drive habilitadas

• Credenciales de OAuth 2.0 para su proyecto de Google Cloud

Related MCP server: Google Search Console MCP

Configuración

1. Clone este repositorio y navegue hasta el directorio del proyecto:

2. Instalar dependencias:

3. Cree un ID de cliente OAuth 2.0 en Google Cloud Console:

   • Vaya a la consola de Google Cloud

   • Crea un nuevo proyecto o selecciona uno existente

   • Habilitar la API de Google Docs y la API de Google Drive

   • Vaya a "API y servicios" > "Credenciales".

   • Haga clic en "Crear credenciales" > "ID de cliente OAuth".

   • Seleccione "Aplicación de escritorio" como tipo de aplicación.

   • Descargue el archivo JSON y guárdelo como credentials.json en el directorio de su proyecto

   Importante : Los archivos credentials.json y token.json contienen información confidencial y están excluidos del control de versiones mediante .gitignore . Nunca los envíe a su repositorio.

4. Construir el proyecto:

5. Ejecutar el servidor:

La primera vez que ejecute el servidor, se le solicitará que se autentique con Google. Siga las instrucciones en pantalla para autorizar la aplicación. Esto generará un archivo token.json que almacena sus tokens de acceso.

Consideraciones de seguridad

• Seguridad de credenciales : Tanto credentials.json como token.json contienen información confidencial y nunca deben compartirse ni enviarse al control de versiones. Ya están añadidos al archivo .gitignore .

• Actualización de token : la aplicación actualiza automáticamente el token de acceso cuando expira.

• Revocar acceso : si necesita revocar el acceso, elimine el archivo token.json y vaya a la configuración de seguridad de su cuenta de Google para eliminar la aplicación de sus aplicaciones autorizadas.

Conectarse a Claude para escritorio

Para utilizar este servidor con Claude for Desktop:

1. Edite su archivo de configuración de Claude Desktop:

   • En macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

   • En Windows: %APPDATA%\Claude\claude_desktop_config.json

2. Añade lo siguiente a tu configuración:

Reemplace /absolute/path/to/build/server.js con la ruta real a su archivo server.js compilado.

3. Reinicie Claude para escritorio.

Interfaz de usuario

El servidor MCP de Google Docs cuenta con una interfaz conversacional fácil de usar que:

• Presenta la información del documento en un formato limpio y legible.

• Utiliza respuestas en lenguaje natural en lugar de datos API sin procesar

• Formatea fechas de forma legible para humanos

• Proporciona preguntas de seguimiento útiles después de las acciones.

• Nunca expone datos confidenciales como tokens OAuth

Este estilo de interfaz está diseñado para coincidir con otras integraciones de Claude MCP como Notion, proporcionando una experiencia de usuario consistente y agradable.

Desarrollo

Estructura del proyecto

Añadiendo nuevas funciones

Para agregar nuevas funciones al servidor MCP:

1. Modifique el archivo src/server.ts para implementar la nueva funcionalidad

2. Construya el proyecto con npm run build

3. Pruebe sus cambios ejecutando npm start

Recursos disponibles

• googledocs://list : enumera todos los documentos de Google Docs en su unidad

• googledocs://{docId} - Obtiene el contenido de un documento específico por ID

Herramientas disponibles

• create-doc : crea un nuevo documento de Google con el título especificado y contenido opcional

• update-doc : actualiza un documento de Google existente con contenido nuevo (agregar o reemplazar)

• insert-text : inserta texto directamente en un documento sin Notion u otras integraciones

• search-docs : busca documentos de Google Docs que contengan texto específico

• delete-doc : elimina un documento de Google por ID

Indicaciones disponibles

• create-doc-template : ayuda a crear un nuevo documento basado en un tema y estilo de escritura específicos

• analyze-doc - Analiza el contenido de un documento y proporciona un resumen

Ejemplos de uso

A continuación se muestran algunos ejemplos de indicaciones que puedes usar con Claude una vez que el servidor esté conectado:

• "Muéstrame una lista de todos mis documentos de Google"

• Crea un nuevo documento de Google titulado "Notas de la reunión" con el contenido "Temas a tratar:...".

• "Actualizar mi documento con ID '1abc123def456' para agregar esta sección al final: ..."

• "Busca en Google Docs cualquier documento que contenga 'propuesta de proyecto'"

• Eliminar el documento de Google con ID '1abc123def456'

• "Crear un documento formal sobre el cambio climático"

• Analizar el contenido del documento con ID '1abc123def456'

Solución de problemas

Si encuentra problemas de autenticación:

1. Elimina el archivo token.json en el directorio de tu proyecto

2. Ejecute el servidor nuevamente para activar un nuevo flujo de autenticación

Si tienes problemas con la API de Google Docs:

1. Asegúrate de que la API esté habilitada en tu Google Cloud Console

2. Comprueba que tus credenciales de OAuth tengan los alcances correctos

Contribuyendo

1. Bifurcar el repositorio

2. Crea una rama de funciones: git checkout -b feature/your-feature-name

3. Confirme sus cambios: git commit -am 'Add some feature'

4. Empujar a la rama: git push origin feature/your-feature-name

5. Enviar una solicitud de extracción

Licencia

Instituto Tecnológico de Massachusetts (MIT)

Variables de entorno

Cree un archivo .env en la raíz del proyecto (o exporte las variables en su shell) con las siguientes claves:

Si se configuran estas variables, el servidor no intentará leer credentials.json o token.json desde el disco.