MCP Email Server

MCP Email Server

一个提供电子邮件功能的 Model Context Protocol 服务。此服务支持大模型撰写和发送电子邮件，以及在指定目录中搜索附件。

功能

• 向多个收件人发送电子邮件
• 支持电子邮件附件
• 根据模式匹配在目录中搜索文件
• 使用 SMTP 安全地传输电子邮件

可用工具

• send_email - 根据提供的主题、正文和收件人发送电子邮件。

  • receiver（字符串数组，必填）：收件人电子邮件地址列表
  • body（字符串，必填）：电子邮件的主要内容
  • subject（字符串，必填）：电子邮件主题
  • attachments（字符串数组或字符串，可选）：电子邮件附件（文件名）

• search_attachments - 在指定目录中搜索符合给定模式的文件。

  • pattern（字符串，必填）：要在文件名中搜索的文本模式

提示词

• send_email

  • 发送包含可选附件的电子邮件
  • 参数：
    • receiver（必填）：收件人电子邮件地址列表
    • body（必填）：电子邮件的主要内容
    • subject（必填）：电子邮件主题
    • attachments（可选）：电子邮件附件

• search_attachments

  • 搜索符合指定模式的文件
  • 参数：
    • pattern（必填）：要在文件名中搜索的文本模式

安装

使用 pip

安装所需依赖：

pip install pydantic python-dotenv

电子邮件配置

包含 SMTP 服务配置的 email.json 文件：

[
  {
    "domain": "@gmail.com",
    "server": "smtp.gmail.com", 
    "port": 587
  },
  {
    "domain": "@outlook.com",
    "server": "smtp.office365.com",
    "port": 587
  },
  {
    "domain": "@yahoo.com",
    "server": "smtp.mail.yahoo.com",
    "port": 587
  }
]

使用方法

运行服务

使用以下命令启动 MCP Email Server：

python -m mcp_email_server (--dir /path/to/attachment/directory)

为 Claude.app 配置

添加到 Claude 设置中：

Conda

{
  "mcpServers": {
    "email": {
      "command": "D:\\conda\\envs\\mcp\\python.exe",
      "args": [
        "C:\\Users\\YourUserName\\Desktop\\servers\\src\\email\\src\\mcp_server_email",
        "--dir",
        "C:\\Users\\YourUserName\\Desktop"
      ],
      "env": {
        "SENDER": "[email protected]",
        "PASSWORD": "tuogk......."
      }
    }
  }
}

UV

{
  "mcpServers": {
    "email": {
      "command": "uv",
      "args": [
        "~\\servers\\src\\email\\src\\mcp_server_email",
        "--dir",
        "C:\\Users\\YourUserName\\Desktop"
      ],
      "env": {
        "SENDER": "[email protected]",
        "PASSWORD": "tuogk......."
      }
    }
  }
}

安全说明

• 对于 Gmail 和其他服务，你可能需要使用应用专用密码
• 出于安全考虑，此服务仅支持有限类型的附件文件

支持的文件类型

此服务支持以下附件文件类型：

• 文档：doc、docx、xls、xlsx、ppt、pptx、pdf
• 归档文件：zip、rar、7z、tar、gz
• 文本文件：txt、log、csv、json、xml
• 图片：jpg、jpeg、png、gif、bmp
• 其他：md

使用示例

发送电子邮件

{
  "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"
}

贡献

欢迎提交贡献，帮助扩展和改进 MCP Email Server。无论你想添加新工具、增强现有功能，还是改进文档，你的贡献都很有价值。

如需查看其他 MCP 服务的示例和实现模式，请参阅： https://github.com/modelcontextprotocol/servers

欢迎提交拉取请求！欢迎贡献新想法、错误修复或增强功能，让 MCP Email Server 更加强大实用。

许可证

MCP Email Server 基于 MIT License 许可。这意味着你可以自由使用、修改和分发此软件，但须遵守 MIT License 的条款和条件。