Servidor MCP de Mailgun

Descripción general

Un servidor del Protocolo de Contexto de Modelos (MCP) para Mailgun que proporciona a los agentes de IA una interfaz práctica y orientada al flujo de trabajo para enviar correos electrónicos, diagnosticar la entregabilidad y gestionar operaciones de la cuenta.

Nota: Este servidor MCP se ejecuta localmente en su máquina. Mailgun no ofrece actualmente una versión alojada de este servidor.

Capacidades

• Mensajería — Enviar correos electrónicos, recuperar mensajes almacenados, reenviar mensajes

• Dominios — Ver detalles del dominio, verificar la configuración de DNS, gestionar la configuración de seguimiento (clics, aperturas, cancelaciones de suscripción)

• Webhooks — Listar, crear, actualizar y eliminar webhooks de eventos

• Rutas — Ver y actualizar reglas de enrutamiento de correo electrónico entrante

• Listas de correo — Crear y gestionar listas de correo y sus miembros

• Plantillas — Crear y gestionar plantillas de correo electrónico con control de versiones

• Análisis — Consultar métricas de envío, métricas de uso y registros

• Estadísticas — Ver estadísticas agregadas por dominio, etiqueta, proveedor, dispositivo y país

• Supresiones — Ver rebotes, cancelaciones de suscripción, quejas y entradas de la lista de permitidos

• IPs y grupos de IP — Ver asignaciones de IP y configuración de grupos de IP dedicados

• Clasificación de rebotes — Analizar tipos de rebote y problemas de entrega

Related MCP server: Enhanced Gmail MCP Server

Requisitos previos

• Node.js (v20.12 o superior)

• Cuenta de Mailgun y clave API

Inicio rápido

Configuración

Añada lo siguiente a la configuración de su cliente MCP:

{
  "mcpServers": {
    "mailgun": {
      "command": "npx",
      "args": ["-y", "@mailgun/mcp-server"],
      "env": {
        "MAILGUN_API_KEY": "YOUR-mailgun-api-key",
        "MAILGUN_API_REGION": "us"
      }
    }
  }
}

Variables de entorno

Rutas de configuración específicas del cliente

• Claude Desktop (macOS): ~/Library/Application Support/Claude/claude_desktop_config.json

• Claude Desktop (Windows): %APPDATA%/Claude/claude_desktop_config.json

• Claude Code: Ejecute claude mcp add o edite ~/.claude.json

Ejemplos de prompts

Enviar un correo electrónico

Can you send an email to EMAIL_HERE with a funny email body that makes it sound
like it's from the IT Desk from Office Space? Please use the sending domain
DOMAIN_HERE, and make the email from "postmaster@DOMAIN_HERE"!

Nota: algunos clientes MCP requieren un plan de pago para invocar herramientas que envían datos. Si el envío falla silenciosamente, verifique el plan de su cliente.

Obtener y visualizar estadísticas de envío

Would you be able to make a chart with email delivery statistics for the past week?

Gestionar plantillas

Create a welcome email template for new signups on my domain DOMAIN_HERE.
Include a personalized greeting and a call-to-action button.

Investigar la entregabilidad

Can you check the bounce classification stats for my account and tell me
what the most common bounce reasons are?

Solucionar problemas de DNS

Check the DNS verification status for my domain DOMAIN_HERE and tell me
if anything needs fixing.

Revisar supresiones

Are there any unsubscribes or complaints for DOMAIN_HERE? Summarize the
top offenders.

Gestionar reglas de enrutamiento

List all my inbound routes and explain what each one does.

Crear una lista de correo

Create a mailing list called announcements@DOMAIN_HERE and add these
members: alice@example.com, bob@example.com.

Comparar dominios

Compare my sending volume and delivery rates across all my domains for
the past month.

Compromiso por región

Break down my email engagement by country and device for DOMAIN_HERE.

Revisar la configuración de seguimiento

List all my domains and show which ones have tracking enabled for clicks
and opens.

Desarrollo

Para ejecutar desde el código fuente, clone el repositorio y utilice node directamente:

git clone https://github.com/mailgun/mailgun-mcp-server.git
cd mailgun-mcp-server
npm install
npm test

En la configuración de su cliente MCP, reemplace el comando npx con:

"command": "node",
"args": ["/path/to/mailgun-mcp-server/src/mailgun-mcp.js"]

Consideraciones de seguridad

Aislamiento de la clave API

Su clave API de Mailgun se pasa como una variable de entorno y nunca se expone al modelo de IA en sí; solo la utiliza el proceso del servidor MCP para autenticar las solicitudes. El servidor no registra claves API, parámetros de solicitud ni datos de respuesta.

Ejecución local

El servidor se ejecuta localmente en su máquina. Toda la comunicación con la API de Mailgun se realiza a través de HTTPS con validación de certificado TLS aplicada. No se envían datos a servicios de terceros más allá de la API de Mailgun.

Permisos de la clave API

Utilice una clave API de Mailgun dedicada con permisos limitados solo a las operaciones que necesite. El servidor expone operaciones de lectura y actualización, pero no expone ninguna operación de eliminación, lo que limita el radio de impacto de acciones no deseadas.

Limitación de tasa (Rate limiting)

El servidor no implementa limitación de tasa del lado del cliente. Cada llamada de herramienta desde la IA se traduce directamente en una solicitud a la API de Mailgun. El servidor depende de los límites de tasa del lado del servidor de Mailgun para evitar abusos; las solicitudes que excedan esos límites devolverán un error al asistente de IA.

Inyección de prompts

Como con cualquier servidor MCP, un prompt diseñado o malintencionado podría engañar al asistente de IA para que llame a operaciones que usted no pretendía, por ejemplo, modificar la configuración de seguimiento o leer los miembros de una lista de correo. Revise las confirmaciones de llamadas a herramientas de su asistente de IA antes de aprobar acciones, especialmente en contextos de prompts no confiables.

URLs de Webhook

Las operaciones de creación y actualización de webhooks aceptan URLs arbitrarias proporcionadas a través del asistente de IA. El servidor MCP pasa estas URLs a la API de Mailgun sin validación adicional. Mailgun es responsable de validar los destinos de los webhooks. Asegúrese de que su asistente de IA no establezca URLs de webhook en direcciones internas o confidenciales no deseadas.

Validación de entrada

Todos los parámetros de las herramientas se validan contra la especificación OpenAPI de Mailgun utilizando esquemas Zod. Sin embargo, la validación depende de la precisión de la especificación OpenAPI, y algunos parámetros de casos extremos pueden recurrir a una validación permisiva. La API de Mailgun realiza su propia validación del lado del servidor como una capa adicional de protección.

Depuración

El servidor MCP se comunica a través de stdio. Consulte la Guía de depuración de MCP para solucionar problemas.

Licencia

Apache 2.0 — consulte LICENSE para obtener más detalles.

Contribución

¡Agradecemos las contribuciones! No dude en enviar un Pull Request o abrir un Issue.