Email MCP Server

此MCP（模型上下文协议）服务器允许您的AI助手为您发送电子邮件。

它能做什么？

您的AI助手可以：

• 发送纯文本和HTML格式的邮件
• 添加文件和文档作为附件
• 使用抄送（CC）和密送（BCC）向多人发送邮件
• 检查您的邮件设置是否正常工作

可用工具

send_email - 简单邮件发送

使用环境配置快速发送邮件：

• 只需指定收件人、主题和正文
• 自动使用您配置的SMTP设置
• 非常适合快速消息

send_custom_email - 高级邮件功能

完全控制地发送邮件：

• 使用抄送（CC）和密送（BCC）向多人发送邮件
• 添加文件附件
• 使用HTML格式
• 覆盖每个邮件的SMTP设置

test_smtp_connection_tool - 检查设置

在发送重要邮件之前测试您的邮件设置。

开始使用

1. 安装所需软件

# 安装uv（Python包管理器）
curl -LsSf https://astral.sh/uv/install.sh | sh

# 重启终端或运行：
source ~/.bashrc

2. 安装项目依赖

cd email-mcp-server
uv sync

3. 测试安装

# 测试您的邮件设置
uv run python test_email.py

# 直接运行服务器（用于测试）
uv run main.py

4. 配置Claude Desktop或Cursor

在您的Claude Desktop配置或Cursor文件中添加以下内容：

{
  "mcpServers": {
      "mcp-server": {
          "command": "uv",
          "args": [
              "--directory",
              "path/to/the/app/email-mcp-server",
              "run",
              "main.py"
          ],
          "env": {
              "SMTP_HOST": "",
              "SMTP_PORT": "",
              "SMTP_SECURE": "",
              "SMTP_USER": "",
              "SMTP_FROM": "",
              "SMTP_PASS": ""
          }
      }
  }
}

重要提示：更改目录路径以匹配您的实际安装位置。

简单示例

发送基本邮件：

"给john@company.com发送一封邮件，说会议定在明天下午2点"

带有HTML格式的邮件：

"给team@company.com发送一封HTML格式的邮件，主题为'每周更新'，并创建一个关于本周进展的漂亮格式的消息"

测试您的设置：

"测试邮件连接，确保其正常工作"

高级示例

向多人发送带附件的邮件：

"给团队发送一封关于项目更新的自定义邮件。发送到team@company.com，抄送给manager@company.com，并附上项目报告"

邮件服务提供商设置

对于Gmail

"env": {
    "SMTP_HOST": "smtp.gmail.com",
    "SMTP_PORT": "587",
    "SMTP_SECURE": "false",
    "SMTP_USER": "your-email@gmail.com",
    "SMTP_FROM": "your-email@gmail.com",
    "SMTP_PASS": "your-app-password"
}

Gmail设置步骤：

1. 启用两步验证
2. 前往Google账户 → 安全 → 应用密码
3. 生成一个“邮件”应用密码
4. 使用16位的应用密码

对于Outlook

"env": {
    "SMTP_HOST": "smtp-mail.outlook.com",
    "SMTP_PORT": "587",
    "SMTP_SECURE": "false",
    "SMTP_USER": "your-email@outlook.com",
    "SMTP_FROM": "your-email@outlook.com",
    "SMTP_PASS": "your-password"
}

对于其他提供商

替换为您的提供商的SMTP设置详情。大多数提供商使用：

• 端口587，SMTP_SECURE=false（STARTTLS）
• 端口465，SMTP_SECURE=true（SSL）

配置变量

变量	描述	示例
SMTP_HOST	您的邮件服务器	smtp.gmail.com
SMTP_PORT	服务器端口	587
SMTP_SECURE	使用SSL（真/假）	false
SMTP_USER	您的用户名	user@gmail.com
SMTP_FROM	发件人地址	noreply@company.com
SMTP_PASS	您的密码	your-password

故障排除

“缺少配置”

• 确保所有环境变量已在Claude Desktop配置中设置
• 检查目录路径是否正确且为绝对路径
• 更改后重新启动Claude Desktop

“身份验证失败”

• 对于Gmail/Yahoo：使用应用密码，而不是常规密码
• 先启用两步验证
• 再次检查用户名和密码

“连接问题”

• 验证SMTP主机和端口是否正确
• 检查您的互联网连接
• 某些网络会阻止SMTP端口

“未找到服务器”

• 确保已安装uv并在PATH中
• 检查目录路径是否存在
• 使用uv sync验证项目依赖是否已安装

测试

# 测试配置和连接
uv run python test_email.py

# 发送一封真实的测试邮件给自己
uv run python test_email.py --send-real

许可证

MIT许可证 - 随意使用和修改。