• 邮件发送：普通文本邮件、HTML邮件、带附件邮件、群发邮件
• 邮件接收与查询：获取文件夹列表、列出邮件、高级搜索、获取邮件详情
• 邮件管理：标记已读/未读、删除邮件、移动邮件
• 附件管理：查看附件列表、下载附件、查看附件内容
• 联系人管理：获取联系人列表、搜索联系人

以下是 Mail MCP 工具的一些核心特点：

• 高级搜索功能：支持多文件夹、关键词、日期范围、发件人、收件人等复杂条件搜索
• 智能联系人管理：自动从邮件历史中提取联系人信息，包括联系频率分析
• 内容范围控制：可以分段查看大型邮件，避免加载过多内容
• 多种邮件格式：支持纯文本和HTML格式邮件的发送和显示
• 附件处理能力：智能识别附件类型，支持文本、图片等不同类型的附件预览
• 安全可靠：本地处理所有邮件操作，不通过第三方服务器转发敏感信息

通过简单的自然语言指令，AI 可以帮助你完成上述所有操作，无需手动编写API调用或在邮件客户端中执行复杂操作。

1. 安装 Node.js 和 npm

   • 访问 Node.js 官网
   • 下载并安装 LTS（长期支持）版本
   • 安装时选择默认选项即可，安装包会同时安装 Node.js 和 npm

2. 验证安装

   • 安装完成后，打开命令提示符（CMD）或 PowerShell
   • 输入以下命令确认安装成功：

     node --version
     npm --version
     

   • 如果显示版本号，则表示安装成功

3. 安装 Git（如果尚未安装）

   • 访问 Git 官网
   • 下载并安装 Git
   • 安装时使用默认选项即可

4. 安装 Python 3.11 或更高版本（必需）

   • 访问 Python 官网
   • 下载并安装 Python 3.11 或更高版本
   • 重要：安装时必须勾选"Add Python to PATH"选项
   • 安装完成后重启电脑，确保环境变量生效

1. 在 Cursor 中，打开或创建 MCP 配置文件：C:\\Users\\你的用户名\\.cursor\\mcp.json

   • 注意：请将 你的用户名 替换为你的 Windows 用户名

2. 添加或修改配置如下：

{
  "mcpServers": {
    "mail-mcp": {
      "command": "pythonw",
      "args": [
        "C:/Users/你的用户名/mcp-mail/bridging_mail_mcp.py"
      ],
      "env": {
        "SMTP_HOST": "smtp.qq.com",
        "SMTP_PORT": "465",
        "SMTP_SECURE": "true",
        "SMTP_USER": "your.email@qq.com",
        "SMTP_PASS": "your-app-specific-password",
        "IMAP_HOST": "imap.qq.com",
        "IMAP_PORT": "993",
        "IMAP_SECURE": "true",
        "IMAP_USER": "your.email@qq.com",
        "IMAP_PASS": "your-app-specific-password",
        "DEFAULT_FROM_NAME": "Your Name",
        "DEFAULT_FROM_EMAIL": "your.email@qq.com"
      }
    }
  }
}

⚠️ 请注意:

• 将 你的用户名 替换为你的 Windows 用户名
• 确保路径正确指向你克隆或解压的项目目录
• 路径应该反映你将项目文件放置的实际位置
• 不要删除克隆或解压的文件夹，这会导致 MCP 无法正常工作

1. 在 Cursor 中，打开或创建 MCP 配置文件：/Users/你的用户名/.cursor/mcp.json

   • 注意：请将 你的用户名 替换为你的 macOS 用户名

2. 添加或修改配置如下：

{
  "mcpServers": {
    "mail-mcp": {
      "command": "pythonw3",
      "args": [
        "/Users/你的用户名/mcp-mail/bridging_mail_mcp.py"
      ]
    }
  }
}

⚠️ 请注意:

• 将 你的用户名 替换为你的 macOS 用户名
• 确保路径正确指向你克隆或解压的项目目录
• 路径应该反映你将项目文件放置的实际位置
• 不要删除克隆或解压的文件夹，这会导致 MCP 无法正常工作

1. 在 Cursor 中，打开或创建 MCP 配置文件：/home/你的用户名/.cursor/mcp.json

   • 注意：请将 你的用户名 替换为你的 Linux 用户名

2. 添加或修改配置如下：

{
  "mcpServers": {
    "mail-mcp": {
      "command": "python3",
      "args": [
        "/home/你的用户名/mcp-mail/bridging_mail_mcp.py"
      ]
    }
  }
}

⚠️ 请注意:

• 将 你的用户名 替换为你的 Linux 用户名
• 确保路径正确指向你克隆或解压的项目目录
• 路径应该反映你将项目文件放置的实际位置
• 不要删除克隆或解压的文件夹，这会导致 MCP 无法正常工作

你可以要求 AI 执行以下操作：

• "列出我的邮箱文件夹"
• "显示收件箱中的最新5封邮件"
• "发送一封主题为'测试邮件'的邮件给example@example.com"
• "搜索包含'发票'关键词的邮件"
• "查看UID为1234的邮件详情"
• "下载邮件中的附件"

本工具基于 MCP (Model Context Protocol) 标准实现，作为 AI 模型与电子邮件服务之间的桥梁。它使用 nodemailer 和 node-imap 作为底层邮件客户端，并通过 Zod 进行请求验证和类型检查。

主要技术组件包括：

• SMTP 客户端：负责所有邮件发送功能，支持HTML内容和附件
• IMAP 客户端：负责连接邮箱服务器，获取邮件列表、详情和附件
• 邮件解析器：使用 mailparser 解析复杂的电子邮件格式
• 内容处理：智能处理HTML和纯文本内容，并支持分段加载大型邮件
• 联系人提取：从邮件历史中自动提取和整理联系人信息

每个邮件操作都被封装为标准化的 MCP 工具，接收结构化参数并返回格式化结果。所有数据都经过处理，以确保以人类可读的格式呈现，使 AI 模型能够轻松理解电子邮件的内容结构。