Notmuch Sendmail

🚀 MCP Notmuch Sendmail

MCP Notmuch Sendmail 作為您的郵件助手，將 Claude 桌面版與您的 notmuch 郵件數據庫連接起來，讓您可以便捷地搜索、瀏覽、編寫和管理郵件，極大提升郵件處理效率。

🚀 快速開始

依賴安裝

pip install markdown-it-py html2text python-notmuch

啟動 MCP Sendmail

python3 mcp_sendmail.py

✨ 主要特性

• 發信：通過 smtplib 發送郵件，支持 HTML 和純文本格式。
• 解析郵件：使用 mail-parser 庫解析郵件內容，識別郵件頭和正文。
• 模板渲染：使用 Jinja2 模板引擎生成自定義郵件內容。
• 附件管理：支持添加任意類型的附件文件。
• 依賴管理：通過 pip 管理所有第三方庫，確保兼容性和可維護性。
• 模塊化設計：功能模塊獨立開發和測試，便於擴展和維護。
• 模板支持：使用 Jinja2 模板引擎實現郵件內容的動態生成。

📦 安裝指南

依賴安裝

pip install markdown-it-py html2text python-notmuch

啟動 MCP Sendmail

python3 mcp_sendmail.py

💻 使用示例

基礎用法

配置 SMTP 信息

在 config.py 文件中填寫您的 SMTP 服務器信息：

_SMTP_SERVER = 'smtp.example.com'
_SMTP_PORT = 587
_SMTP_USERNAME = 'your_email@example.com'
_SMTP_PASSWORD = 'your_password'

發送郵件示例

# 發送純文本郵件
send_plain_text("收件人郵箱", "郵件主題", "郵件正文內容")

# 發送 HTML 格式郵件
send_html_email("收件人郵箱", "郵件主題", "<h1>HTML 郵件</h1><p>這是 HTML 格式的郵件正文。</p>", ["attachment1.pdf"])

高級用法

純文本郵件發送

def send_plain_text(to, subject, body):
    msg = MIMEText(body)
    msg['Subject'] = subject
    msg['From'] = _SMTP_USERNAME
    msg['To'] = to
    
    with smtplib.SMTP(_SMTP_SERVER, _SMTP_PORT) as server:
        server.starttls()
        server.login(_SMTP_USERNAME, _SMTP_PASSWORD)
        server.sendmail(_SMTP_USERNAME, [to], msg.as_string())

HTML 格式郵件發送

def send_html_email(to, subject, html_content, attachments=None):
    msg = MIMEMultipart('alternative')
    msg.attach(MIMEText('', 'plain', 'utf-8'))
    
    templateLoader = jinja2.FileSystemLoader(searchpath="./templates")
    templateEnv = jinja2.Environment(loader=templateLoader)
    template = templateEnv.get_template("email_template.html")
    output_text = template.render()
    
    part = MIMEText(output_text, 'html')
    msg.attach(part)
    
    if attachments:
        for attachment in attachments:
            with open(attachment, 'rb') as file:
                part = MIMEBase('application', 'octet-stream')
                part.set_payload(file.read())
                encoders.encode_base64(part)
                part.add_header('Content-Disposition', f'attachment; filename="{os.path.basename(attachment)}"')
                msg.attach(part)
    
    with smtplib.SMTP(_SMTP_SERVER, _SMTP_PORT) as server:
        server.starttls()
        server.login(_SMTP_USERNAME, _SMTP_PASSWORD)
        server.sendmail(_SMTP_USERNAME, [to], msg.as_string())

📚 詳細文檔

項目結構

mcp_sendmail/
├── sendmail.py         # 郵件發送核心邏輯
├── templates/          # HTML 郵件模板文件夾
│   └── email_template.html    # 示例 HTML 郵件模板
└── config.py           # SMTP 服務器配置信息

貢獻與支持

• 問題報告：歡迎提交任何遇到的問題或改進建議。
• 功能擴展：希望增加更多郵件發送和管理功能。
• 文檔完善：幫助完善項目文檔，使更多人能夠輕鬆使用。

通過 MCP Notmuch Sendmail，讓 Claude 桌面版成為您強大的郵件管理工具。