What is Mail Mcp

mail_mcp is a lightweight email sending service built on the FastMCP framework. It allows users to send emails easily through a simple API interface using the SMTP protocol, with all configurations managed via a .env file.

Use cases

Use cases for mail_mcp include sending user registration confirmations, password reset emails, promotional messages, and system alerts, making it suitable for both personal and business applications.

How to use

To use mail_mcp, first install the required dependencies with ‘pip install fastmcp python-dotenv’. Then, create a .env configuration file with your SMTP settings, including your email credentials. Start the service by running ‘python email_sender.py’, and use the provided RESTful API to send emails by making a POST request to ‘http://localhost:2224/tool/send_email’ with the email subject and message in JSON format.

Key features

Key features of mail_mcp include one-click email sending, centralized configuration management via .env files, secure SSL/TLS connections, customizable sender information, detailed logging, a standardized RESTful API, and cross-platform support for Windows, Linux, and macOS.

Where to use

mail_mcp can be used in various fields such as web applications, automated notification systems, and any service that requires reliable email communication.

邮件发送服务

一个基于 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
[email protected]
SMTP_PASS=your_auth_code

# 发件人配置
DEFAULT_FROM_NAME=邮件服务
[email protected]

# 收件人配置
[email protected]

# 服务配置
SERVICE_PORT=2224

替换为您的实际配置：

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

启动服务

python email_sender.py

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

邮件发送服务配置
发件人: 邮件服务 <[email protected]>
收件人: [email protected]
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)

响应示例

成功响应:

"邮件成功发送至 [email protected]"

失败响应:

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

配置说明

.env 文件配置项

常见邮箱服务商配置参考

常见问题

邮箱认证失败怎么办？

• 检查 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]。

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