fastmcp-email-server 0.1.0

FastMCP 邮件收发 MCP 服务器

FastMCP 邮件服务器

基于 FastMCP 框架构建的邮件收发 MCP 服务器，支持多种邮箱服务商的邮件收发和附件处理功能。

🚀 FastMCP 框架特性

FastMCP 提供了简洁的 Python 风格接口，只需使用装饰器即可将函数封装为 MCP 工具：

from fastmcp import FastMCP

mcp = FastMCP("EmailService")

@mcp.tool()
def send_text_email(to_addr: str, subject: str, content: str, account: str, password: str) -> dict:
    """发送纯文本邮件"""
    # 实现邮件发送逻辑
    return {"status": "success", "message": "邮件发送成功"}

if __name__ == "__main__":
    mcp.run(transport="stdio")

📧 提供的邮件工具

邮件接收

• get_newest_email: 获取最新的未读邮件
• check_emails: 检查指定类型和数量的邮件
• save_attachment: 保存邮件附件到指定路径

邮件发送

• send_text_email: 发送纯文本邮件
• send_html_email: 发送HTML格式邮件
• send_email_with_attachment: 发送带附件的邮件

服务器配置

• get_server_config: 自动获取邮箱服务器配置

📦 安装与运行（使用 uv）

安装依赖

uv sync

以模块方式运行（推荐）

uv run -m fastmcp_email_server

或使用安装的脚本入口：

uv run fastmcp-email-server

直接运行源码（可选）

uv run python src/fastmcp_email_server/server.py

🔧 调试模式

使用 MCP Inspector 进行调试：

uv run mcp dev src/fastmcp_email_server/server.py

访问 http://localhost:5173 进行交互测试。

📋 支持的邮箱服务商

• 163邮箱（163.com）
• 126邮箱（126.com）
• QQ邮箱（qq.com）
• Gmail（gmail.com）
• Outlook/Hotmail（outlook.com, hotmail.com）
• 阿里云邮箱（aliyun.com）
• 新浪邮箱（sina.com）

💡 使用示例

配置 MCP 客户端

在支持 MCP 的客户端（Claude Desktop、Cherry Studio、Cursor 等）中配置：

{
  "mcpServers": {
    "email": {
  "command": "uv",
  "args": [
    "run",
    "-m",
    "fastmcp_email_server"
  ],
      "env": {}
    }
  }
}

工具调用示例

{
  "name": "send_text_email",
  "arguments": {
    "to_addr": "[e-mail]",
    "subject": "测试邮件",
    "content": "这是一封测试邮件",
    "account": "[e-mail]", 
    "password": "your-auth-code"
  }
}

🔐 邮箱授权码说明

大多数邮箱服务商需要使用授权码而不是登录密码：

• 163/126邮箱: 邮箱设置 → 客户端授权密码 → 开启并获取授权码
• QQ邮箱: 设置 → 账户 → 开启POP3/IMAP服务并获取授权码
• Gmail: 开启两步验证并生成应用专用密码

📁 项目结构

src/
└── fastmcp_email_server/
    ├── __init__.py          # 包入口，提供命令行主函数
    ├── __main__.py          # 支持 python -m 形式运行
    ├── server.py            # FastMCP 服务器主文件
    ├── email_config.py      # 邮箱服务器配置
    ├── send_163.py          # 邮件发送功能
    └── receive_163.py       # 邮件接收功能