Gmail

Servidor MCP de Gmail

Un servidor basado en el Protocolo de Contexto de Modelo (MCP) que proporciona funcionalidad de eliminación de correos de Gmail.

Funciones

• Expone herramientas de eliminación de correos de Gmail a través del protocolo MCP
• Admite la eliminación de correos de un usuario específico mediante el ID del correo
• Proporciona funcionalidad de búsqueda de correos, con soporte para consultas por criterios
• Admite la eliminación masiva de múltiples correos de un usuario específico

Requisitos del entorno

• Java 17 o superior
• Maven 3.6+ o Gradle 7.0+
• Archivo credentials.json de la API de Gmail

Inicio rápido

1. Preparar las credenciales de la API de Gmail

1. Vaya a Google Cloud Console
2. Cree un nuevo proyecto y habilite la API de Gmail
3. Cree credenciales de ID de cliente OAuth 2.0
4. Descargue el archivo credentials.json y guárdelo en el directorio src/main/resources/

2. Construir el proyecto

./mvnw clean install

3. Ejecutar el servidor

./mvnw spring-boot:run

Configuración

El archivo de configuración se encuentra en src/main/resources/application.properties; se pueden modificar los siguientes parámetros:

• server.port: Puerto del servidor, por defecto 8080
• spring.ai.mcp.server.enabled: Si se habilita el servidor MCP, por defecto true
• gmail.credentials.path: Ruta del archivo de credenciales de Gmail, por defecto classpath:credentials.json

Uso

Después de conectarse al servidor mediante un cliente MCP, se pueden invocar las siguientes herramientas:

• deleteEmail: Elimina el correo con el ID especificado
  • Parámetros: userId (correo del usuario), messageId (ID del correo)
• searchEmails: Busca correos que coincidan con los criterios
  • Parámetros: userId (correo del usuario), query (criterios de búsqueda), maxResults (número máximo de resultados)
  • Valor de retorno: lista de correos, que incluye el ID del correo e información básica
• batchDeleteEmails: Elimina correos de forma masiva
  • Parámetros: userId (correo del usuario), messageIds (lista de IDs de correos)
  • Valor de retorno: estado del resultado de la operación

Configuración del servidor MCP

{
  "mcpServers": {
    "gmail-mcp-server": {
    "command": "java",
    "args": [
      "-Dspring.ai.mcp.server.stdio=true",
      "-Dspring.main.web-application-type=none",
      "-Dlogging.pattern.console=",
      "-jar",
      "/Users/arthur/.m2/repository/arthur/mcp/gmail-mcp-server/0.0.1-SNAPSHOT/gmail-mcp-server-0.0.1-SNAPSHOT.jar"
    ]
    }
  }
}