Aws Ses MCP

🚀 アマゾンSES MCP 📧

このプロジェクトは、アマゾンSES（Simple Email Service）を通じて電子メールを送信するためのシンプルなMCPサーバーです。CursorやClaude Desktopと統合するのに最適で、ツール内から直接メールを作成して送信でき、コピー＆ペーストの手間が省けます。このサービスは、プレーンテキストとHTML形式のメールをサポートし、CC、BCC、返信先アドレスなどの高度な機能も備えています。

🚀 クイックスタート

このアマゾンSES MCPを使うことで、CursorやClaude Desktopなどのツールから直接アマゾンSESを通じて電子メールを送信できます。以下の手順に従ってセットアップしてください。

✨ 主な機能

• プレーンテキストとHTML形式の電子メールの送信
• 抄送（CC）と密送（BCC）の受信者をサポート
• 設定可能な返信先アドレス
• カスタマイズ可能な送信元メールアドレス（アマゾンSESでの検証が必要）
• デバッグしやすいように、すべてのリクエストとレスポンスをログに記録
• メールの予約送信機能

📦 インストール

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がプロキシモードであることを確認してください。

開発とトラブルシューティング

依存関係をインストールします。

npm install

プロジェクトをビルドします。

npm run build

詳細情報を取得するには、コンソールログを確認します。

npm start

注意事項

このプロジェクトは、既存のツールに簡単に統合できるメール送信ソリューションです。アマゾンSESの強力な機能を利用しながら、メール送信のプロセスを簡素化しています。ただし、ユーザーは一定のAWS設定知識が必要で、適切に権限を設定し、メールアドレスを検証する必要があります。

実際の使用では、大量のメール送信の処理方法（レート制限を考慮する必要があるか）、異なる送信元アドレスの管理方法、メールがアマゾンSESによってスパムとしてマークされないようにする方法などの問題に直面する可能性があります。また、ログ記録機能は、メール送信状況のデバッグと監視に非常に重要です。

将来的には、このプロジェクトを改善するために、テンプレートサポート、メールキューシステム、またはより詳細なエラー処理メカニズムなどの機能を追加することが考えられます。また、ドキュメントで言及されている「email.md」形式を拡張して、より多くのメールオプションをサポートできるかどうかも検討する価値があります。

前提条件

開始する前に、以下の条件を満たしていることを確認してください。

1. アマゾンSESアカウントを設定し、構成していること。
2. アマゾンSESでメールドメインまたは個人のメールアドレスを検証していること。
3. アマゾンSESの権限を持つAWS資格情報（アクセスキーIDとシークレットアクセスキー）を持っていること。
4. システムにNode.jsがインストールされていること。