MCP Server Smtp

🚀 SMTP 郵件 MCP 服務器

SMTP 郵件 MCP 服務器是一個提供電子郵件發送功能的 Model Context Protocol (MCP) 服務器，適用於 Claude 和其他與 MCP 兼容的 AI 助手，能高效滿足各類郵件發送需求。

🚀 快速開始

SMTP 郵件 MCP 服務器可幫助你輕鬆實現郵件發送功能。以下是啟動服務器的基本步驟：

# 克隆倉庫
git clone https://github.com/samihalawa/mcp-server-smtp.git
cd mcp-server-smtp

# 安裝依賴
npm install

# 構建服務器
npm run build

# 啟動服務器
npm start

✨ 主要特性

• 多個 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

向一個或多個收件人發送郵件。

send-email(
  to: [{ email: "recipient@example.com", name: "John Doe" }],
  subject: "這是一個測試郵件",
  body: "<p>這是一封測試郵件。</p>",
  from: { email: "sender@example.com", name: "Sender Name" }
)

參數說明：

• to：包含電子郵件地址和可選名稱的收件人數組
• subject：郵件主題
• body：郵件正文（支持 HTML）
• from：（可選）發件人電子郵件地址和名稱
• cc：（可選）抄送收件人
• bcc：（可選）密送收件人
• templateId：（可選）使用的模板 ID
• templateData：（可選）傳遞給模板的數據

send-bulk-emails

發送大批量郵件。

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
)

參數說明：

• recipients：包含電子郵件地址和可選名稱的收件人數組
• subject：郵件主題
• body：郵件正文（支持 HTML）
• batchSize：每次發送的郵件數量
• delayBetweenBatches：每批發送之間的延遲時間（以毫秒為單位）

📚 詳細文檔

配置示例

示例 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 許可證。