MCP 邮件服务器

一个提供邮件功能的模型上下文协议服务器。该服务器使 LLM 能够撰写和发送电子邮件，以及在指定目录中搜索附件。

功能

• 发送给多个收件人的电子邮件
• 支持电子邮件附件
• 基于模式匹配在目录中搜索文件
• 使用 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": "report"
}

贡献

我们鼓励您贡献力量，以帮助扩展和改进 MCP 邮件服务器。 无论您是想添加新工具、增强现有功能还是改进文档，您的投入都很有价值。

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

欢迎提交 Pull Request！ 随时贡献新的想法、错误修复或增强功能，以使 MCP 邮件服务器更加强大和有用。

许可证

MCP 邮件服务器在 MIT 许可证下获得许可。 这意味着您可以自由使用、修改和分发该软件，但须遵守 MIT 许可证的条款和条件。