Aws Ses MCP

🚀 亞馬遜SES MCP 📧

這是一個簡單的MCP服務器，可藉助亞馬遜SES（簡單電子郵件服務）來發送電子郵件。它特別適合與Cursor或Claude Desktop集成，讓你能直接在工具裡編寫併發送郵件，無需進行復制粘貼操作。該服務支持純文本和HTML格式的郵件，還具備抄送（CC）、密送（BCC）和設置回覆地址（Reply - to）等高級功能。

🚀 快速開始

此項目是一個便於集成到現有工具中的郵件發送解決方案。它藉助亞馬遜SES的強大功能，同時簡化了郵件發送流程。不過，用戶需要具備一定的AWS配置知識，並且正確設置權限和驗證電子郵件地址。

✨ 主要特性

• 可發送純文本和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 處於代理模式。

開發和故障排除

1. 安裝依賴項：

npm install

2. 構建項目：

npm run build

3. 檢查控制檯日誌以獲取更多信息：

npm start

注意事項與展望

在實際使用中，可能遇到的問題包括：如何處理大量的郵件發送（是否需要考慮速率限制）、如何管理不同的發件人地址、以及如何確保郵件不會被亞馬遜SES標記為垃圾郵件。此外，日誌記錄功能對於調試和監控郵件發送情況也非常重要。

未來，如果要改進這個項目，可以考慮添加更多功能，比如模板支持、郵件排隊系統或者更詳細的錯誤處理機制。同時，文檔中提到的“email.md”格式是否可以擴展，以支持更多的郵件選項也是一個值得探討的方向。