Servidor MCP de Gmail

Un servidor de integración de Gmail potente y flexible, desarrollado con el framework MCP (Protocolo de Control de Mensajes). Este servidor proporciona una interfaz robusta para interactuar con las API de Gmail, ofreciendo funcionalidades para leer, enviar y gestionar correos electrónicos programáticamente.

Características

• Leer correos electrónicos de varias cuentas de Gmail

• Enviar correos electrónicos con archivos adjuntos

• Buscar correos electrónicos con opciones de consulta avanzadas

• Descargar archivos adjuntos de correo electrónico

• Gestionar conversaciones y hilos de correo electrónico

• Monitoreo de correo electrónico en tiempo real

• Compatibilidad con múltiples cuentas de Gmail

Prerrequisitos

Antes de ejecutar el servidor MCP de Gmail, asegúrese de tener lo siguiente:

1. Python 3.12 o superior

2. Proyecto de Google Cloud con la API de Gmail habilitada

3. Credenciales de ID de cliente de OAuth 2.0

4. Paquetes de Python necesarios (especificados en pyproject.toml)

Instalación

Instalación mediante herrería

Para instalar Gmail Integration Server para Claude Desktop automáticamente a través de Smithery :

1. Clonar el repositorio:

2. Crear y activar un entorno virtual:

3. Instalar dependencias:

Configurar el proyecto de Google Cloud

1. Vaya a la consola de Google Cloud

2. Crea un nuevo proyecto o selecciona uno existente

3. Habilite la API de Gmail para su proyecto

4. Crear credenciales OAuth 2.0:

   • 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

   • Descargar el archivo de configuración del cliente

5. Cambie el nombre del archivo descargado a client_secret.json y colóquelo en el directorio raíz del proyecto

Configuración

1. Configurar identificadores de correo electrónico en gmail_token_creator.py :

2. Ejecute el creador de tokens para autenticar sus cuentas de Gmail:

3. Repita el proceso para cada cuenta de Gmail que desee integrar

Estructura del servidor

• gmail_server.py : Implementación del servidor MCP principal

• gmail_api.py : Funciones de interacción de la API de Gmail

• google_apis.py : utilidades de autenticación de la API de Google

• Archivos de apoyo:

  • read_emails.py : funcionalidad de lectura de correo electrónico

  • search_emails.py : Función de búsqueda de correo electrónico

  • send_emails.py : funcionalidad de envío de correo electrónico

Uso

Iniciando el servidor

Herramientas disponibles

1. Enviar correo electrónico:

2. Buscar correos electrónicos:

3. Leer los últimos correos electrónicos:

4. Descargar archivos adjuntos:

Consideraciones de seguridad

• Almacene client_secret.json de forma segura y nunca lo envíe al control de versiones

• Mantenga los archivos de token seguros y agréguelos a .gitignore

• Utilice variables de entorno para información confidencial

• Rotar periódicamente las credenciales de OAuth

• Supervisar el uso de la API y establecer cuotas adecuadas

Manejo de errores

El servidor incluye gestión y registro de errores integrales:

• Los registros se escriben en gmail_mcp.log

• Tanto el registro de archivos como el de consola están habilitados

• Mensajes de error detallados para depuración

Contribuyendo

1. Bifurcar el repositorio

2. Crear una rama de características

3. Confirme sus cambios

4. Empujar hacia la rama

5. Crear una solicitud de extracción

Licencia

Licencia Apache 2.0

Apoyo

Para problemas y solicitudes de funciones, utilice el rastreador de problemas de GitHub.