AWS SES

aws-ses-mcp 📧

Este é um servidor MCP simples que envia e-mails usando o AWS SES (Simple Email Service). Perfeito para integrar com Cursor ou Claude Desktop para compor e enviar e-mails diretamente, sem copiar e colar. O serviço suporta e-mails em texto simples e HTML, com recursos avançados como CC, CCO e funcionalidade de resposta (reply-to).

Recursos ✨

• Enviar e-mails em texto simples e HTML
• Suporte para destinatários em CC e CCO
• Endereços de resposta (reply-to) configuráveis
• E-mail do remetente personalizável (requer verificação no AWS SES)
• Registro completo de requisições/respostas para depuração
• Capacidade de agendamento de e-mails

Pré-requisitos 📋

Antes de começar, certifique-se de ter:

1. Conta AWS SES configurada e ativada
2. Domínio de e-mail verificado ou endereços de e-mail individuais no AWS SES
3. Credenciais AWS (Access Key ID e Secret Access Key) com permissões para SES
4. Node.js instalado no seu sistema

Instalação 🚀

Instalação via Smithery

Para instalar o aws-ses-mcp para Claude Desktop automaticamente via Smithery:

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

Instalação Manual

1. Clone este repositório:

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

2. Instale as dependências:

npm install

3. Compile o projeto:

npm run build

Configuração ⚙️

Exemplo de Formato de E-mail (email.md)

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

Instruções de Configuração 🔧

Para Cursor

1. Vá para Configurações do Cursor -> MCP -> Adicionar novo servidor MCP

2. Configure o servidor com estas configurações:

   • Nome: aws-ses-mcp (ou o nome de sua preferência)
   • 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

Adicione a seguinte configuração ao seu arquivo de configuração 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. Crie ou edite o email.md com o conteúdo do seu e-mail
2. No Cursor:
   • Abra o arquivo email.md
   • Selecione o conteúdo
   • Pressione cmd+l (ou ctrl+l)
   • Diga ao Cursor para "enviar isto como um e-mail"
   • Certifique-se de que o chat do Cursor esteja no modo Agente

Desenvolvimento 👩‍💻

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

Solução de Problemas 🔍

• Verifique os logs do console para obter informações detalhadas de requisições/respostas
• Verifique suas credenciais e permissões AWS
• Certifique-se de que o e-mail do remetente esteja verificado no AWS SES
• Revise o console do AWS SES para verificar rejeições (bounces) ou reclamações

Contribuição 🤝

Contribuições são bem-vindas! Sinta-se à vontade para enviar um Pull Request.

Licença 📄

Este projeto está licenciado sob a Licença MIT - consulte o arquivo LICENSE para obter detalhes.

A Licença MIT é uma licença permissiva, curta e direta. Ela permite que as pessoas façam o que quiserem com o seu código, desde que forneçam atribuição a você e não o responsabilizem.