邮件发送服务

一个基于 FastMCP 框架的轻量级邮件发送服务，通过简单的 API 接口即可发送电子邮件。服务使用 SMTP 协议发送邮件，所有配置通过 .env 文件集中管理。

功能特性

• 🚀 一键发送：只需提供标题和内容即可发送邮件
• ⚙️ 集中配置：通过 .env 文件管理所有设置
• 🔒 安全连接：支持 SSL/TLS 加密传输
• 📧 自定义发件人：可设置发件人名称和邮箱
• 📊 详细日志：完整的运行日志和错误记录
• 🌐 RESTful API：标准化的接口设计
• 🔄 跨平台：支持 Windows/Linux/macOS

快速开始

安装依赖

pip install fastmcp python-dotenv

配置服务

创建 .env.example 配置文件：

# SMTP 配置
SMTP_HOST=smtp.qq.com
SMTP_PORT=587
SMTP_SECURE=false
SMTP_USER=your_email@qq.com
SMTP_PASS=your_auth_code

# 发件人配置
DEFAULT_FROM_NAME=邮件服务
DEFAULT_FROM_EMAIL=your_email@qq.com

# 收件人配置
DEFAULT_RECEIVER_EMAIL=recipient@example.com

# 服务配置
SERVICE_PORT=2224

替换为您的实际配置：

• SMTP_USER：您的邮箱账号
• SMTP_PASS：邮箱密码或授权码
• DEFAULT_FROM_NAME：发件人显示名称
• DEFAULT_FROM_EMAIL：发件人邮箱地址
• DEFAULT_RECEIVER_EMAIL：默认收件人邮箱

启动服务

python email_sender.py

服务启动后将显示配置信息：

邮件发送服务配置
发件人: 邮件服务 <your_email@qq.com>
收件人: recipient@example.com
SMTP服务器: smtp.qq.com:587 (安全连接: 否)
服务端口: 2224

服务已启动，等待请求...

API 接口

基本信息

• URL: http://localhost:2224/tool/send_email
• 方法: POST
• Content-Type: application/json

请求参数

{
  "subject": "邮件主题",
  "message": "邮件正文内容"
}

调用示例

使用 curl

curl -X POST http://localhost:2224/tool/send_email 
  -H "Content-Type: application/json" 
  -d '{
    "subject": "测试邮件",
    "message": "这是一封来自邮件服务的测试邮件"
  }'

使用 Python

import requests

url = "http://localhost:2224/tool/send_email"
headers = {"Content-Type": "application/json"}
data = {
    "subject": "Python测试邮件",
    "message": "这是一封通过Python脚本发送的测试邮件"
}
response = requests.post(url, json=data, headers=headers)

print(response.text)

响应示例

成功响应:

"邮件成功发送至 recipient@example.com"

失败响应:

"邮箱认证失败，请检查用户名和密码/授权码是否正确"

配置说明

.env 文件配置项

配置项	说明	默认值	必填
SMTP_HOST	SMTP服务器地址	无	✅
SMTP_PORT	SMTP端口号	无	✅
SMTP_SECURE	是否使用SSL/TLS加密	false	❌
SMTP_USER	SMTP用户名/邮箱	无	✅
SMTP_PASS	SMTP密码/授权码	无	✅
DEFAULT_FROM_NAME	默认发件人名称	"邮件服务"	❌
DEFAULT_FROM_EMAIL	默认发件人邮箱	SMTP_USER的值	❌
DEFAULT_RECEIVER_EMAIL	默认收件人邮箱	无	✅
SERVICE_PORT	服务监听端口	2224	❌

常见邮箱服务商配置参考

邮箱服务商	SMTP_HOST	SMTP_PORT	SMTP_SECURE
QQ邮箱	smtp.qq.com	465	true
	smtp.qq.com	587	false
163邮箱	smtp.163.com	465	true
Gmail	smtp.gmail.com	587	false
Outlook	smtp.office365.com	587	false

常见问题

邮箱认证失败怎么办？

• 检查 SMTP_USER 和 SMTP_PASS 是否正确
• 对于QQ邮箱，请使用授权码而非密码
• 确保邮箱已开启SMTP服务（通常在邮箱设置中）

如何发送给不同的收件人？

修改 .env 文件中的 DEFAULT_RECEIVER_EMAIL 配置项，或者修改代码支持动态收件人。

服务启动时报错 "KeyError" 怎么办？

确保 .env 文件中包含了所有必需的配置项，特别是：

• SMTP_HOST
• SMTP_PORT
• SMTP_USER
• SMTP_PASS
• DEFAULT_RECEIVER_EMAIL

如何修改服务端口？

在 .env 文件中设置 SERVICE_PORT 为所需端口号：

SERVICE_PORT=8080

安全建议

• 保护敏感信息：
  • 不要将 .env 文件提交到版本控制系统
  • 将 .env 添加到 .gitignore 文件中
• 使用专用邮箱：
  • 创建专门用于发送邮件的邮箱账户
  • 启用应用专用密码（如QQ邮箱的授权码）
• 限制访问：
  • 仅在安全网络环境下运行服务
  • 考虑添加API密钥验证机制
• 定期更新：
  • 定期更换邮箱授权码
  • 关注服务的安全更新

项目结构

email-service/
├── .env.example            # 配置文件模板
├── mail.py         # 主程序
└── README.md               # 说明文档

许可证

本项目采用 [LICENSE]。

开始使用邮件发送服务，让您的应用轻松集成邮件功能！ 📨✨