项目简介

这是一个轻量级的应用后端服务,遵循 Model Context Protocol (MCP)。它提供了一个专门的功能:通过标准的 SMTP 协议发送电子邮件。通过将此服务器与支持 MCP 的大型语言模型 (LLM) 客户端集成,可以赋予 AI 自动发送电子邮件的能力,而无需 LLM 直接处理复杂的 SMTP 配置或交互逻辑。

主要功能点

  • 支持多种传输模式: 可以在标准输入输出 (stdio)、Server-Sent Events (SSE) 或 Streamable HTTP 模式下运行,方便本地测试、集成或远程部署。
  • 提供电子邮件发送工具: 封装了一个名为 'send_email' 的工具,AI 客户端可以通过调用此工具来执行邮件发送操作。
  • 支持灵活的邮件格式: 允许发送纯文本或 HTML 格式的电子邮件,并支持抄送 (CC) 和密送 (BCC)。
  • 通过环境变量配置: SMTP 服务器地址、发件人邮箱和 SMTP 密码等敏感信息通过环境变量安全地提供给服务器。

安装步骤

该项目提供了预编译的可执行文件,安装过程非常简便:

  1. 打开终端。
  2. 运行以下命令下载并执行安装脚本:
    curl https://raw.githubusercontent.com/Allenxuxu/email-mcp/HEAD/download.sh | bash
  3. 脚本执行完成后,当前目录下会出现一个名为 'send-email' 的可执行文件,这就是 MCP 服务器程序。

服务器配置(供 MCP 客户端参考)

MCP 服务器需要通过配置信息告知 MCP 客户端如何启动或连接。此 MCP 服务器程序 ('send-email') 依赖于几个关键配置,通常通过环境变量提供:

  • 'SMTPPASSWORD': 发件邮箱的 SMTP 密码(或授权码),必需。
  • 'SMTPADDRESS': SMTP 服务器地址及端口,例如 'smtp.example.com:465',必需。
  • 'SENDEREMAIL': 发件人邮箱地址,必需。
  • 'MODE': 服务器运行模式,可选值为 'stdio' (默认), 'sse', 'streamable'。对于远程部署通常设置为 'sse' 或 'streamable'。
  • 'ADDRESS': 服务器监听地址,仅在 'sse' 或 'streamable' 模式下使用,默认 '127.0.0.1:8080'。

MCP 客户端在配置此服务器时,需要指定启动 'send-email' 可执行文件的命令 ('command'),并将必要的 SMTP 配置作为环境变量 ('env') 传递给该进程。对于远程模式,客户端则配置连接到服务器的 URL。

基本使用方法

  1. 配置服务器: 按照上述说明,设置必需的环境变量(如 SMTP 密码、地址、发件人邮箱)来启动 'send-email' 程序。选择合适的 'MODE' 和 'ADDRESS'。
  2. 配置 MCP 客户端: 在支持 MCP 的 LLM 客户端中,添加对该服务器的配置,指定 'send-email' 可执行文件的路径和启动参数(包括环境变量)。
  3. AI 调用工具: 一旦客户端连接到服务器,AI 将发现一个名为 'send_email' 的可用工具。
  4. 执行邮件发送: 当用户指示 AI 发送邮件时,AI 会调用 'send_email' 工具,并在调用参数中提供收件人 ('to')、主题 ('subject')、邮件正文 ('text' 或 'html') 等信息。服务器接收到请求后,将使用配置的 SMTP 信息实际发送邮件。

信息

分类

AI与计算