Mail

🚀 發郵件 MCP 使用說明

本項目提供了一個發郵件的 MCP 工具，可幫助用戶方便地配置和使用郵件發送服務，支持不同操作系統的配置，能發送普通郵件和帶附件的郵件。

🚀 快速開始

配置指南

Windows 系統配置

1. 打開 Cursor 編輯器，找到或創建 mcp.json 文件，路徑為：C:\Users\你的用戶名\.cursor\mcp.json
2. 添加或修改以下內容到文件中：

{
  "mcpServers": {
    "mail-mcp": {
      "command": "pythonw",
      "args": [
        "C:\\Users\\你的用戶名\\mcp-mail\\bridging_mail_mcp.py"
      ],
      "env": {
        "NODEMAILER_SMTP_HOST": "smtp.example.com",
        "NODEMAILER_SMTP_PORT": "587",
        "NODEMAILER_SMTP_USER": "your.email@example.com",
        "NODEMAILER_SMTP_PASSWORD": "your_password",
        "IMAP_CLIENT_EMAIL_ADDRESS": "your.email@example.com",
        "IMAP_CLIENT_PASSWORD": "your_password"
      }
    }
  }
}

⚠️ 重要提示

• 將 你的用戶名 替換為實際的 Windows 用戶名
• 確保路徑正確指向項目文件的實際位置
• 不要刪除或移動項目文件夾

macOS 系統配置

1. 打開終端，運行命令：cd ~ && ls -a 查看隱藏目錄
2. 在 ~/.cursor/ 目錄下創建或編輯 mcp.json 文件
3. 添加以下內容到文件中：

{
  "mcpServers": {
    "mail-mcp": {
      "command": "pythonw",
      "args": [
        "/Users/你的用戶名/mcp-mail/bridging_mail_mcp.py"
      ],
      "env": {
        "NODEMAILER_SMTP_HOST": "smtp.example.com",
        "NODEMAILER_SMTP_PORT": "587",
        "NODEMAILER_SMTP_USER": "your.email@example.com",
        "NODEMAILER_SMTP_PASSWORD": "your_password",
        "IMAP_CLIENT_EMAIL_ADDRESS": "your.email@example.com",
        "IMAP_CLIENT_PASSWORD": "your_password"
      }
    }
  }
}

⚠️ 重要提示

• 將 你的用戶名 替換為實際的 macOS 用戶名
• 確保路徑正確指向項目文件的實際位置
• 不要刪除或移動項目文件夾

Linux 系統配置

1. 打開終端，運行命令：cd ~ && ls -a 查看隱藏目錄
2. 在 ~/.cursor/ 目錄下創建或編輯 mcp.json 文件
3. 添加以下內容到文件中：

{
  "mcpServers": {
    "mail-mcp": {
      "command": "pythonw",
      "args": [
        "/home/你的用戶名/mcp-mail/bridging_mail_mcp.py"
      ],
      "env": {
        "NODEMAILER_SMTP_HOST": "smtp.example.com",
        "NODEMAILER_SMTP_PORT": "587",
        "NODEMAILER_SMTP_USER": "your.email@example.com",
        "NODEMAILER_SMTP_PASSWORD": "your_password",
        "IMAP_CLIENT_EMAIL_ADDRESS": "your.email@example.com",
        "IMAP_CLIENT_PASSWORD": "your_password"
      }
    }
  }
}

⚠️ 重要提示

• 將 你的用戶名 替換為實際的 Linux 用戶名
• 確保路徑正確指向項目文件的實際位置
• 不要刪除或移動項目文件夾

啟動服務

1. 打開終端，運行以下命令啟動 MCP 服務：

   npm start mcp
   

2. 查看控制檯輸出，確認服務啟動成功

💻 使用示例

基礎用法

const mcp = require('mcp');

// 發送普通郵件
mcp.sendEmail({
    from: 'your.email@example.com',
    to: 'recipient@example.com',
    subject: '測試郵件',
    text: '這是一封測試郵件'
}).then(() => {
    console.log('郵件發送成功');
}).catch(error => {
    console.error('發送失敗:', error);
});

高級用法

// 發送帶附件的郵件
mcp.sendEmail({
    from: 'your.email@example.com',
    to: 'recipient@example.com',
    subject: '帶附件的測試郵件',
    text: '請查收附件',
    attachments: [
        {
            filename: 'test.txt',
            content: '這是附件內容'
        }
    ]
}).then(() => {
    console.log('郵件發送成功');
}).catch(error => {
    console.error('發送失敗:', error);
});

📚 詳細文檔

郵件發送流程

1. 初始化 MCP 服務：配置 SMTP 和 IMAP 參數，建立與郵件服務器的連接
2. 創建郵件內容：包括髮件人、收件人、主題和正文等信息
3. 添加附件（可選）：將文件附加到郵件中
4. 發送郵件：通過SMTP協議將郵件發送到目標郵箱

技術實現

• 使用 nodeMailer 庫處理 SMTP 通信
• 使用 mail客戶端庫 處理 IMAP 操作
• 支持附件處理和多種郵件格式
• 提供錯誤處理和日誌記錄功能

🔧 技術細節

依賴項和環境要求

• 依賴項：需要安裝 nodeMailer 和 mail客戶端庫
• 環境變量：配置 SMTP 和 IMAP 信息通過環境變量實現

技術特性

• 使用 nodeMailer 庫處理 SMTP 通信，確保郵件發送的高效和穩定。
• 運用 mail客戶端庫 處理 IMAP 操作，方便對郵件進行接收和管理。
• 支持附件處理和多種郵件格式，滿足不同的使用場景。
• 提供完善的錯誤處理和日誌記錄功能，便於排查和解決問題。

📄 許可證

本項目遵循 MIT 許可證，可以自由使用和修改。如果有任何問題，請聯繫技術支持。