MCP 邮件服务器

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

功能

• 发送带有多个收件人的电子邮件
• 支持电子邮件附件
• 基于模式匹配在目录中搜索文件
• 使用SMTP进行安全的电子邮件传输

可用工具

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

  • receiver (字符串数组, 必填): 收件人电子邮件地址列表
  • body (字符串, 必填): 电子邮件的主要内容
  • subject (字符串, 必填): 电子邮件的主题行
  • attachments (字符串或字符串数组, 可选): 电子邮件附件(文件名)

• search_attachments - 在指定目录中搜索与给定模式匹配的文件。

  • pattern (字符串, 必填): 要在文件名中搜索的文本模式

提示

• send_email

  • 发送带有可选附件的电子邮件
  • 参数:
    • receiver (必填): 收件人电子邮件地址列表
    • body (必填): 电子邮件的主要内容
    • subject (必填): 电子邮件的主题行
    • attachments (可选): 电子邮件附件

• search_attachments

  • 搜索与模式匹配的文件
  • 参数:
    • pattern (必填): 要在文件名中搜索的文本模式

安装

使用pip

安装所需的依赖项：

bash
pip install pydantic python-dotenv

邮件配置

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

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邮件服务器：

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

为Claude.app配置

将以下配置添加到您的Claude设置中：

Conda

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

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

示例用法

发送电子邮件

json
{
"receiver": ["recipient@example.com"],
"subject": "来自MCP服务器的测试邮件",
"body": "这是一封通过MCP邮件服务器发送的测试邮件。",
"attachments": ["document.pdf", "image.jpg"]
}

搜索附件

json
{
"pattern": "report"
}

贡献

我们鼓励贡献以帮助扩展和完善MCP邮件服务器。无论您想添加新工具、增强现有功能还是改进文档，您的输入都是宝贵的。有关其他MCP服务器和实现模式的示例，请参阅：
https://github.com/modelcontextprotocol/servers

欢迎提交拉取请求！请随时贡献新想法、修复错误或进行增强，以使MCP电子邮件服务器更加强大和有用。

许可证

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