JinDaGe - aws-ses-mcp MCP Details

article

README

🚀 亚马逊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”格式是否可以扩展，以支持更多的邮件选项也是一个值得探讨的方向。

aws-ses-mcp