aws-ses-mcp 📧

aws-ses-mcp 📧

这是一个简单的 MCP 服务，可使用 AWS SES（Simple Email Service）发送电子邮件。非常适合与 Cursor 或 Claude Desktop 集成，让你无需复制粘贴即可直接撰写和发送电子邮件。该服务支持纯文本和 HTML 电子邮件，并提供抄送、密送和回复地址等高级功能。

功能 ✨

• 发送纯文本和 HTML 电子邮件
• 支持抄送和密送收件人
• 可配置回复地址
• 可自定义发件人电子邮件地址（需要通过 AWS SES 验证）
• 记录完整的请求和响应，便于调试
• 支持邮件定时发送

前提条件 📋

开始之前，请确保你已具备：

1. 已设置并配置 AWS SES 账户
2. 已在 AWS SES 中验证的电子邮件域名或个人电子邮件地址
3. 具备 SES 权限的 AWS 凭证（Access Key ID 和 Secret Access Key）
4. 系统中已安装 Node.js

安装 🚀

通过 Smithery 安装

通过 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": "[email protected]",
  "subject": "Test!",
  "text": "This is a test email.",
  "cc": ["[email protected]"],
  "bcc": ["[email protected]"]
}

设置说明 🔧

对于 Cursor

1. 前往 Cursor Settings -> MCP -> Add new MCP server

2. 使用以下设置配置服务：

   • 名称：aws-ses-mcp（或你偏好的名称）
   • 类型：command
   • 命令：

   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
   

对于 Claude Desktop

将以下配置添加到你的 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"
      }
    }
  }
}

使用方法 📝

1. 创建或编辑 email.md，填写电子邮件内容
2. 在 Cursor 中：
   • 打开 email.md 文件
   • 选择内容
   • 按 cmd+l（或 ctrl+l）
   • 告诉 Cursor“将此内容作为电子邮件发送”
   • 确保 Cursor 聊天处于 Agent 模式

开发 👩‍💻

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

故障排除 🔍

• 查看控制台日志，了解详细的请求和响应信息
• 检查 AWS 凭证和权限
• 确保发件人电子邮件地址已在 AWS SES 中验证
• 查看 AWS SES 控制台，检查是否有退信或投诉

贡献 🤝

欢迎贡献！请随时提交 Pull Request。

许可证 📄

本项目采用 MIT License 授权，详情请参阅 LICENSE 文件。

MIT License 是一种宽松、简明扼要的许可证。只要注明代码归属并且不追究你的责任，其他人就可以随意使用你的代码。