亚马逊SES MCP 📧

这是一个简单的MCP服务器，用于通过亚马逊SES（简单电子邮件服务）发送电子邮件。非常适合与Cursor或Claude Desktop集成，直接从工具中编写和发送电子邮件，而无需复制粘贴。该服务支持纯文本和HTML格式的电子邮件，并具有高级功能，如抄送（CC）、密送（BCC）和回复地址（Reply-to）。

特性 ✨

• 发送纯文本和HTML格式的电子邮件
• 支持抄送（CC）和密送（BCC）收件人
• 可配置的回复地址
• 可自定义的发件人电子邮箱（需要亚马逊SES验证）
• 全请求/响应日志记录，便于调试
• 邮件计划功能

先决条件 📋

在开始之前，请确保您具备以下条件：

1. 已设置并配置了亚马逊SES账户
2. 在亚马逊SES中验证了电子邮件域名或个人电子邮箱地址
3. 具备亚马逊 SES 权限的 AWS 凭证（访问密钥 ID 和秘密访问键）
4. 系统上已安装 Node.js

安装 🚀

通过 Smithery 自动安装

要自动为Claude Desktop安装aws-ses-mcp：

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

手动安装

1. 克隆此仓库：

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

2. 安装依赖项：

npm install

3. 构建项目：

npm run build

配置

提供了一个示例 email.md 文件格式，如下所示：

{
  "to": "recipient@example.com",
  "cc": ["copy@example.com"],
  "bcc": ["blind@example.com"],
  "replyTo": "reply@example.com",
  "subject": "Test Email",
  "body": "This is a test email sent using aws-ses-mcp."
}

设置说明

对于 Cursor

通过 MCP 设置添加新的服务器，并指定相应的命令和参数。

对于 Claude Desktop

在配置中添加相关的环境变量：

{
  "awsAccessKeyId": "YOUR_AWS_ACCESS_KEY_ID",
  "awsSecretAccessKey": "YOUR_AWS_SECRET_ACCESS_KEY",
  "region": "us-west-2"
}

使用方法

创建或编辑 email.md 文件，然后在 Cursor 中选择内容并发送电子邮件。确保 Cursor 处于代理模式。

开发和故障排除

安装依赖项：

npm install

构建项目：

npm run build

检查控制台日志以获取更多信息：

npm start

这个项目是一个方便集成到现有工具中的邮件发送解决方案。它利用亚马逊SES的强大功能，同时简化了邮件发送的过程。需要注意的是，用户需要具备一定的 AWS 配置知识，并且正确设置权限和验证电子邮件地址。

在实际使用中，可能遇到的问题包括：如何处理大量的邮件发送（是否需要考虑速率限制）、如何管理不同的发件人地址、以及如何确保邮件不会被亚马逊SES标记为垃圾邮件。此外，日志记录功能对于调试和监控邮件发送情况也非常重要。

未来，如果要改进这个项目，可以考虑添加更多功能，比如模板支持、邮件排队系统或者更详细的错误处理机制。同时，文档中提到的“email.md”格式是否可以扩展，以支持更多的邮件选项也是一个值得探讨的方向。