AWS SES

aws-ses-mcp 📧

Este es un servidor MCP simple que envía correos electrónicos usando AWS SES (Simple Email Service). Perfecto para integrar con Cursor o Claude Desktop para redactar y enviar correos directamente sin copiar y pegar. El servicio admite correos en texto plano y HTML con funciones avanzadas como CC, CCO y respuesta a.

Características ✨

• Envío de correos en texto plano y HTML
• Soporte para destinatarios CC y CCO
• Direcciones de respuesta configurables
• Remitente personalizable (requiere verificación en AWS SES)
• Registro completo de solicitudes/respuestas para depuración
• Capacidad de programación de correos

Requisitos previos 📋

Antes de comenzar, asegúrate de tener:

1. Una cuenta de AWS SES configurada
2. Dominio de correo verificado o direcciones de correo individuales en AWS SES
3. Credenciales de AWS (Access Key ID y Secret Access Key) con permisos para SES
4. Node.js instalado en tu sistema

Instalación 🚀

Instalación mediante Smithery

Para instalar aws-ses-mcp para Claude Desktop automáticamente a través de Smithery:

npx -y @smithery/cli install @omd01/aws-ses-mcp --client claude

Instalación manual

1. Clona este repositorio:

git clone https://github.com/omd01/aws-ses-mcp.git
cd aws-ses-mcp

2. Instala las dependencias:

npm install

3. Compila el proyecto:

npm run build

Configuración ⚙️

Formato de correo de ejemplo (email.md)

{
  "to": "example@gmail.com",
  "subject": "Test!",
  "text": "This is a test email.",
  "cc": ["cc-recipient@example.com"],
  "bcc": ["bcc-recipient@example.com"]
}

Instrucciones de configuración 🔧

Para Cursor

1. Ve a Configuración de Cursor -> MCP -> Añadir nuevo servidor MCP

2. Configura el servidor con estos ajustes:

   • Nombre: aws-ses-mcp (o el nombre que prefieras)
   • Tipo: command
   • Comando:

   node ABSOLUTE_PATH_TO_MCP_SERVER/build/index.js \
   --aws-access-key-id=YOUR_AWS_ACCESS_KEY_ID \
   --aws-secret-access-key=YOUR_AWS_SECRET_ACCESS_KEY \
   --aws-region=YOUR_AWS_REGION \
   --sender=YOUR_SENDER_EMAIL \
   --reply-to=REPLY_TO_EMAIL
   

Para Claude Desktop

Añade la siguiente configuración a tu configuración de MCP:

{
  "mcpServers": {
    "aws-ses-mcp": {
      "command": "node",
      "args": ["ABSOLUTE_PATH_TO_MCP_SERVER/build/index.js"],
      "env": {
        "AWS_ACCESS_KEY_ID": "YOUR_AWS_ACCESS_KEY_ID",
        "AWS_SECRET_ACCESS_KEY": "YOUR_AWS_SECRET_ACCESS_KEY",
        "AWS_REGION": "YOUR_AWS_REGION",
        "SENDER_EMAIL_ADDRESS": "YOUR_SENDER_EMAIL",
        "REPLY_TO_EMAIL_ADDRESSES": "REPLY_TO_EMAILS_COMMA_SEPARATED"
      }
    }
  }
}

Uso 📝

1. Crea o edita email.md con el contenido de tu correo
2. En Cursor:
   • Abre el archivo email.md
   • Selecciona el contenido
   • Pulsa cmd+l (o ctrl+l)
   • Dile a Cursor que "envíe esto como un correo"
   • Asegúrate de que el chat de Cursor esté en modo Agente

Desarrollo 👩‍💻

npm install    # Install dependencies
npm run build  # Build the project

Solución de problemas 🔍

• Revisa los registros de consola para obtener información detallada de solicitudes/respuestas
• Verifica tus credenciales y permisos de AWS
• Asegúrate de que tu correo de remitente esté verificado en AWS SES
• Revisa la consola de AWS SES para ver si hay rebotes o quejas

Contribuciones 🤝

¡Las contribuciones son bienvenidas! No dudes en enviar un Pull Request.

Licencia 📄

Este proyecto está licenciado bajo la Licencia MIT; consulta el archivo LICENSE para más detalles.

La Licencia MIT es una licencia permisiva, corta y directa. Permite que las personas hagan lo que quieran con tu código siempre que te atribuyan el crédito y no te hagan responsable.