星战科技xingzhan.cloud
返回市场
MCP邮件服务器

MCP邮件服务器

作者：shuakami41 星标更新：2025-11-12
安装使用来源：spider==github.com

项目介绍

Mail MCP 工具

ISC 许可证 Node.js TypeScript 邮件 smithery 徽章

基于上述信息，执行以下指令：您是一位负责将英文内容翻译成英文内容的专业翻译人员。请帮助我翻译原始内容。

这是什么

这是一个基于MCP（模型上下文协议）的电子邮件工具，它使AI模型能够通过标准化接口访问电子邮件服务。

简单来说，它使AI助手能够执行各种电子邮件操作，如发送电子邮件、阅读收件箱、处理附件等，而无需用户手动输入复杂的API调用或切换到电子邮件客户端。

<details> <summary><b>支持的功能</b>（点击展开）</summary>
  • 发送电子邮件纯文本电子邮件、HTML电子邮件、带附件的电子邮件、群发电子邮件
  • 接收和查询电子邮件获取文件夹列表、列出电子邮件、高级搜索、获取电子邮件详情
  • 管理电子邮件标记为已读/未读、删除电子邮件、移动电子邮件
  • 管理附件查看附件列表、下载附件、查看附件内容
  • 联系人管理检索联系人列表、搜索联系人
</details> <details> <summary><b>功能特点</b>（点击展开）</summary>

以下是Mail MCP工具的一些核心功能：

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

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

</details>

快速开始

0. 环境准备

<details> <summary>如果您之前没有使用过 Node.js（点击展开）</summary>

  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 或更高版本
    • 重要在安装过程中，请务必勾选“将 Python 添加到 PATH”选项
    • 安装完成后重启计算机确保环境变量生效
</details>

通过 Smithery 安装

要通过 Smithery 自动安装 Mail MCP 工具给 Claude Desktop

npx -y @smithery/cli install @shuakami/mcp-mail --client claude

克隆并安装

git clone https://github.com/shuakami/mcp-mail.git
cd mcp-mail
npm install
npm run build

2. 构建项目

npm run build

3. 添加到 Cursor MCP 配置

根据您的操作系统，按照以下步骤配置 MCP：

<details> <summary><b>Windows 配置</b>（点击展开）</summary>

  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 失效
</details> <details> <summary><b>macOS 配置</b>（点击展开）</summary>

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

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

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

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

⚠️ 请注意

  • 将 你的用户名 替换为您的 macOS 用户名
  • 确保路径正确指向您克隆或解压项目的目录
  • 路径应反映您放置项目文件的实际位置
  • 不要删除克隆或解压的文件夹这会导致 MCP 失效
</details> <details> <summary><b>Linux 配置</b>（点击展开）</summary>

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

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

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

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

⚠️ 请注意

  • 将 你的用户名 替换为您的 Linux 用户名
  • 确保路径正确指向您克隆或解压项目的目录
  • 路径应反映您放置项目文件的实际位置
  • 不要删除克隆或解压的文件夹这会导致 MCP 失效
</details>

4. 启动服务

配置完成后，重新启动 Cursor 编辑器，它会自动启动 MCP 服务。然后您就可以开始使用了。

<details> <summary>使用示例（点击展开）</summary>
  • 列出我的电子邮件文件夹
  • 显示收件箱中的最新5封邮件
  • 发送主题为“测试邮件”的电子邮件至 example@example.com
  • 搜索包含关键词‘发票’的邮件
  • 查看UID为1234的邮件详情
  • 下载邮件中的附件
</details>

工作原理

<details> <summary>技术实现细节（点击展开）</summary>

该工具基于 MCP（模型上下文协议） 标准实现，作为AI模型与电子邮件服务之间的桥梁。它使用 nodemailer 和 node-imap 作为底层电子邮件客户端，并通过 Zod 执行请求验证和类型检查。

主要技术组件包括：

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

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

</details>

许可证

ISC

如果这个项目对您有帮助，请随意给它一个星⭐️ (｡♥‿♥｡)