MCP 邮件服务器

这是一个提供邮件功能的模型上下文协议（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邮件服务器：

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": "2593666979q@gmail.com",
        "PASSWORD": "tuogk......."
      }
    }
  }
}

UV

{
  "mcpServers": {
    "email": {
      "command": "uv",
      "args": [
        "~\\servers\\src\\email\\src\\mcp_server_email",
        "--dir",
        "C:\\Users\\YourUserName\\Desktop"
      ],
      "env": {
        "SENDER": "2593666979q@gmail.com",
        "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": ["recipient@example.com"],
  "subject": "来自MCP服务器的测试邮件",
  "body": "这是一封通过MCP邮件服务器发送的测试邮件。",
  "attachments": ["document.pdf", "image.jpg"]
}

搜索附件

{
  "pattern": "报告"
}

贡献

我们鼓励对MCP邮件服务器进行贡献，以帮助扩展和改进它。无论您想添加新工具、增强现有功能还是改进文档，您的意见都是宝贵的。

有关其他MCP服务器和实现模式的例子，请参见： https://github.com/modelcontextprotocol/servers

欢迎提交拉取请求！请自由地提出新想法、修复错误或改进，使MCP邮件服务器更强大和有用。

许可证

MCP邮件服务器根据MIT许可证授权。这意味着您可以自由使用、修改和分发该软件，但需遵守MIT许可证的条款和条件。