aws-ses-mcp 📧

aws-ses-mcp 📧

AWS SES（Simple Email Service）を使用してメールを送信する、シンプルな MCP サーバーです。Cursor や Claude Desktop と連携すれば、コピー＆ペーストすることなく、メールを直接作成して送信できます。CC、BCC、返信先などの高度な機能に加え、プレーンテキストメールと HTML メールの両方に対応しています。

機能 ✨

• プレーンテキストメールと HTML メールの送信
• CC と BCC の宛先に対応
• 返信先アドレスを設定可能
• 送信者メールアドレスをカスタマイズ可能（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 コンソールを確認します

コントリビューション 🤝

コントリビューションを歓迎します！お気軽にプルリクエストを送信してください。

ライセンス 📄

このプロジェクトは MIT License の下でライセンスされています。詳細は LICENSE ファイルをご覧ください。

MIT License は、簡潔で要点を押さえた寛容なライセンスです。あなたへの帰属表示を行い、あなたに責任を負わせない限り、誰でもあなたのコードを自由に利用できます。