MCP Email Server

MCP Email Server

site icon
2025.03.28 8
Python电子邮件服务附件管理交流协作
MCP Email Server 是一个基于 Model Context Protocol 的服务器,提供电子邮件功能。该服务器使 LLMs(大型语言模型)能够撰写和发送电子邮件,并在指定目录中搜索附件。
View on GitHub

Overview

基本能力

产品定位

MCP Email Server 是一个专注于电子邮件处理的服务器,旨在通过协议化的方式提供电子邮件发送和附件搜索功能。

核心功能

  • 发送电子邮件,支持多收件人
  • 支持电子邮件附件
  • 基于模式匹配在目录中搜索文件
  • 使用 SMTP 进行安全的电子邮件传输

适用场景

  • 自动化电子邮件发送
  • 批量处理电子邮件附件
  • 集成到大型语言模型(LLMs)中以扩展其电子邮件处理能力

工具列表

  • send_email:发送电子邮件,支持主题、正文、收件人和附件
  • receiver(必需):收件人电子邮件地址列表
  • body(必需):电子邮件正文内容
  • subject(必需):电子邮件主题
  • attachments(可选):电子邮件附件(文件名)
  • search_attachments:在指定目录中搜索匹配给定模式的文件
  • pattern(必需):用于在文件名中搜索的文本模式

常见问题解答

  • 对于 Gmail 等服务,可能需要使用应用专用密码
  • 服务器出于安全原因支持有限的附件文件类型

使用教程

使用依赖

安装所需的依赖项:

pip install pydantic python-dotenv

安装教程

  1. 配置 email.json 文件,包含 SMTP 服务器配置。
  2. 启动 MCP Email Server:
python -m mcp_email_server (--dir /path/to/attachment/directory)

调试方式

  1. 确保 email.json 文件配置正确。
  2. 检查 SMTP 服务器是否可访问。
  3. 验证附件目录是否存在且可读。

示例用法

发送电子邮件

{
  "receiver": ["[email protected]"],
  "subject": "Test Email from MCP Server",
  "body": "This is a test email sent via the MCP Email Server.",
  "attachments": ["document.pdf", "image.jpg"]
}

搜索附件

{
  "pattern": "report"
}

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。