🚀 亚马逊SES MCP 📧
这是一个简单的MCP服务器，可借助亚马逊SES（简单电子邮件服务）来发送电子邮件。它特别适合与Cursor或Claude Desktop集成，让你能直接在工具里编写并发送邮件，无需进行复制粘贴操作。该服务支持纯文本和HTML格式的邮件，还具备抄送（CC）、密送（BCC）和设置回复地址（Reply - to）等高级功能。
🚀 快速开始
此项目是一个便于集成到现有工具中的邮件发送解决方案。它借助亚马逊SES的强大功能，同时简化了邮件发送流程。不过，用户需要具备一定的AWS配置知识，并且正确设置权限和验证电子邮件地址。
✨ 主要特性
- 可发送纯文本和HTML格式的电子邮件。
- 支持添加抄送（CC）和密送（BCC）收件人。
- 可对回复地址进行配置。
- 发件人电子邮箱可自定义（需亚马逊SES验证）。
- 全请求/响应日志记录，方便调试。
- 具备邮件计划功能。
📦 安装指南
先决条件 📋
在开始之前，请确保您具备以下条件：
- 已设置并配置了亚马逊SES账户。
- 在亚马逊SES中验证了电子邮件域名或个人电子邮箱地址。
- 拥有具备亚马逊 SES 权限的 AWS 凭证（访问密钥 ID 和秘密访问键）。
- 系统上已安装 Node.js。
安装步骤
通过 Smithery 自动安装
要自动为Claude Desktop安装aws - ses - mcp，可执行以下命令：
npx -y @smithery/cli install @omd01/aws-ses-mcp --client claude
手动安装
- 克隆此仓库：
git clone https://github.com/omd01/aws-ses-mcp.git
cd aws-ses-mcp
- 安装依赖项：
npm install
- 构建项目：
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标记为垃圾邮件。此外，日志记录功能对于调试和监控邮件发送情况也非常重要。
未来，如果要改进这个项目，可以考虑添加更多功能，比如模板支持、邮件排队系统或者更详细的错误处理机制。同时，文档中提到的“email.md”格式是否可以扩展，以支持更多的邮件选项也是一个值得探讨的方向。