MCP Server Smtp

🚀 SMTP メール MCP サーバ

Model Context Protocol (MCP) を使用したメール送信機能を提供するサーバです。Claude やその他の MCP 互換の AI アシスタントで利用できます。

✨ 主な機能

• 複数の SMTP 設定：複数の SMTP サーバを設定および管理できます。
• メールテンプレート：再利用可能な電子メールテンプレートを作成、更新、使用できます。
• バッチメール送信：複数の受信者にメールを送信でき、バッチ送信とレート制限をサポートします。
• HTML サポート：リッチなメールコンテンツを実現するための完全な HTML サポートがあります。
• ログ記録：すべてのメール活動を完全にログ記録します。
• テンプレート変数：テンプレート変数を使用して動的なコンテンツを実現できます。

📦 インストール

# リポジトリをクローン
git clone https://github.com/samihalawa/mcp-server-smtp.git
cd mcp-server-smtp

# 依存関係をインストール
npm install

# サーバをビルド
npm run build

💻 使用例

基本的な使用法

サーバの起動

npm start

設定

サーバを MCP 設定に追加します。

{
  "servers": {
    "smtp-email-server": {
      "command": "/path/to/node",
      "args": ["/path/to/mcp-server-smtp/build/index.js"],
      "enabled": true,
      "port": 3007,
      "environment": {
        "NODE_PATH": "/path/to/node_modules",
        "PATH": "/usr/local/bin:/usr/bin:/bin"
      }
    }
  }
}

利用可能なツール

send-email

1 人以上の受信者にメールを送信します。 パラメータ：

• to：電子メールアドレスとオプションの名前を含む受信者の配列
• subject：メールの件名
• body：メール本文（HTML をサポート）
• from：（オプション）送信者の電子メールアドレスと名前
• cc：（オプション）同報受信者
• bcc：（オプション）秘匿同報受信者
• templateId：（オプション）使用するテンプレートの ID
• templateData：（オプション）テンプレートに渡すデータ

例：

send-email(
  to: [{ email: "recipient@example.com", name: "John Doe" }],
  subject: "これはテストメールです",
  body: "<p>これはテストメールです。</p>",
  from: { email: "sender@example.com", name: "Sender Name" }
)

send-bulk-emails

大量のメールを送信します。 パラメータ：

• recipients：電子メールアドレスとオプションの名前を含む受信者の配列
• subject：メールの件名
• body：メール本文（HTML をサポート）
• batchSize：一度に送信するメールの数
• delayBetweenBatches：バッチ間の遅延時間（ミリ秒）

例：

send-bulk-emails(
  recipients: [
    { email: "user1@example.com", name: "User 1" },
    { email: "user2@example.com", name: "User 2" }
  ],
  subject: "重要なお知らせ",
  body: "<p>これは重要なお知らせです。</p>",
  batchSize: 10,
  delayBetweenBatches: 1000
)

高度な使用法

設定例

例 1：SMTP サーバの設定

# SMTPサーバを設定
config smtp {
    host = "smtp.example.com"
    port = 587
    secure = false
    authentication {
        username = "your-email@example.com"
        password = "your-app-password"
    }
}

例 2：メールテンプレートの作成

# ウェルカムメールテンプレートを作成
template welcome-email {
    subject = "ようこそ {{company}} へ！"
    body = "<h1>こんにちは、{{name}}！</h1><p>ようこそ {{company}} へ！</p>"
}

例 3：パーソナライズされたメールの送信

# パーソナライズされたメールを送信
send-email(
    to: { email: "new-user@example.com", name: "New User" },
    templateId = "welcome-email",
    templateData = {
        name = "New User",
        company = "例の会社"
    }
)

📚 ドキュメント

要件

• Node.js 14 以上
• メール送信に Nodemailer を使用
• SMTP サーバへのアクセス権限

📄 ライセンス

MIT