← 返回目录

MCP Email Server

社区

通过 IMAP 和 SMTP 读取、搜索、整理和发送邮件的多账户 MCP 服务器

查看安装方法 ↓ 横向对比 GitHub 源仓库 ↗

分类: 其他第 71 / 230
Stars: ★ 361 非常热门
传输方式: stdio（本地进程）
运行环境: Python
凭据: 需要 API Key / 凭据
许可证: BSD-3-Clause
最近提交: 9 天前

60FMRS · C

一个功能较为完整的多账户邮件 MCP 服务器，支持跨平台运行和图形化配置，但源材料未列出具体工具名称，且邮箱凭据的本地存储和发送邮件权限需要用户谨慎评估风险。

最强项 · 维护活跃度 15/20 最弱项 · 可靠性 8/20

可靠性

8/20

安全与权限

11/20

维护活跃度

15/20

文档质量

14/20

安装易用性

12/20

查看各项评分依据

可靠性 8/20: 仅能依据 README 静态判断:项目声明使用 FastMCP,提供 stdio 传输的启动命令,并有构建状态徽章暗示存在 CI。但本次评审未获得服务器清单(manifest 未缓存)、工具列表或任何测试文件的直接证据,无法核实声明的工具与实际行为是否一致,也无法确认 MCP 初始化/工具列表握手在实际运行中的表现。README 中提到的'legacy 兼容模式'和迁移流程也暗示配置路径存在版本分支和潜在的边缘情况,但错误处理细节未在提供材料中体现。按静态评审规则,在缺乏可验证的 CI 与测试证据的情况下不得超过 12 分,故给出 8 分。
安全与权限 11/20: 该服务器涉及 IMAP/SMTP 凭据处理与真实的发信副作用。README 提到密码通过 keyring 存储、旧版 TOML 与 keyring 条目在迁移时保持不动且不被覆盖,导入流程有'预览优先'和需要输入 IMPORT 确认的机制,显示出对破坏性操作有一定的确认设计,这是加分项。但材料中没有显示发送邮件(SMTP send)这一具有外部影响的动作在被调用时是否需要额外确认或范围限制,也没有说明多账户之间的权限隔离细节或网络访问边界的完整披露(具体安全文档未包含在提供材料中,只有外链)。未发现红线级问题(无恶意代码、无隐蔎凭据窃取迹象、无未经确认的不可逆危险默认行为的证据),故不适用红线评分,但因权限范围与确认机制的证据不完整,扣分至 11 分。
维护活跃度 15/20: 仓库未被归档,采用 BSD-3-Clause 许可证,存在版本发布徽章、GitHub Actions 构建状态徽章与 Codecov 覆盖率徽章,表明存在持续集成与版本发布流程。开放issue仅2个,star数301,说明有一定使用基础和相对及时的问题处理(尽管未直接看到issue历史)。文档站点独立维护(mcp-email-server.wh1isper.top),README 中出现版本升级说明(如'Local Email App V2'),显示项目在持续演进。因缺乏具体的提交频率、发布日期和issue响应时间的直接证据,不能给满分,给15分。
文档质量 14/20: README 结构清晰,包含快速开始、MCP 客户端配置示例、可选迁移路径、以及指向外部文档站点的多个分类链接(入门、配置、工具、传输方式、安全、故障排查)。有专门的 docs/security.md 与故障排查链接,说明文档分层较为完善。但关键工具参数说明、速率限制、成本说明等具体内容均未包含在本次提供材料中,只能看到指向外部文档的链接而无法核实其内容完整性,存在'文档存在但未验证'的不确定性,故扣分,给14分。
安装易用性 12/20: README 提供了从 uv sync/uv run 到配置 MCP 客户端 JSON 的具体步骤,以及使用 uvx 的发布版调用方式,步骤描述较为具体。但整个配置过程依赖运行一个前台 UI 程序完成账户设置,且存在'legacy'与'managed'两种模式、迁移预览与二次确认等额外复杂性,增加了实际操作步骤和门槛,不能算作'few-step setup'。同时静态评审规则规定,若无可验证的执行证据(真实 CI 加上覆盖关键路径的测试),setup 不得超过15分,而本次材料中未直接展示这些证据,故进一步下调至12分。

静态评测 · 未实际运行收录于 2026-08-26

查看 FMRS 评分方法 →

选型与风险

能访问什么访问网络修改第三方账户数据

适合谁

需要在 MCP 客户端中直接读取/搜索/整理/发送邮件的个人或团队用户
使用多个 IMAP/SMTP 邮箱账户、希望统一管理的场景
熟悉 uv/uvx 及本地凭据管理、能自行完成邮箱账户配置的用户

不适合谁

不希望在本地存储邮箱密码/凭据的用户
需要 OAuth（如 Gmail/Outlook 现代认证）而非账号密码登录的场景（源材料未提及是否支持）
需要云端托管、无需本地配置的邮件服务的用户

所需权限

存储并使用邮箱账户的用户名/密码等凭据（本地 keyring 或 SQLite 托管存储）
通过 IMAP 读取和搜索邮箱内容
通过 SMTP 以用户身份发送邮件
本地文件系统访问，用于读写配置文件（TOML 或 SQLite 数据库）

风险与副作用

邮箱凭据存储在本地（legacy 模式为 TOML/keyring，V2 为 SQLite 托管存储），凭据泄露将导致邮箱被未授权访问
赋予 AI 客户端发送邮件的能力，误操作或恶意提示可能导致意外发送邮件
从旧版配置迁移到 V2 的过程涉及凭据导入，操作不当可能导致导入冲突或凭据缺失

安装接入

准备工作

运行环境：Python

1) 在源码目录执行 uv sync 后运行 uv run mcp-email-server ui（或对已发布版本使用 uvx mcp-email-server@latest ui）打开配置界面，添加邮箱账户的邮箱地址和密码，常见连接参数会根据邮箱域名自动填充且可编辑；2) 如需要可点击“Password & test”测试连接；3) 在 MCP 客户端配置中加入形如 {"mcpServers": {"mcp-email-server": {"command": "uvx", "args": ["mcp-email-server@latest", "stdio"]}}} 的服务器定义；4) 重启 MCP 客户端使配置生效；5) 让客户端列出已配置的邮箱账户或最近邮件以验证连接。

MCP 配置 · JSON

{"mcpServers": {"mcp-email-server": {"command": "uvx", "args": ["mcp-email-server@latest", "stdio"]}}}

适用于使用 mcpServers 字段的客户端。VS Code 等使用其他字段的客户端，可用下方配置生成器转换。

.vscode/mcp.json

{
  "servers": {
    "mcp-email-server": {
      "command": "uvx",
      "args": [
        "mcp-email-server@latest",
        "stdio"
      ]
    }
  }
}

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

claude mcp add mcp-email-server -- uvx mcp-email-server@latest stdio

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

在 MCP 客户端中请求列出已配置的邮箱账户或最近邮件，能返回账户/邮件列表即说明连接成功。

常见排障

修改配置后未生效：确认已重启 MCP 客户端
迁移旧配置遇到冲突或凭据缺失：参考官方文档的导入故障排查章节，并可运行 `config doctor` 检查配置状态
确认使用的是支持 V2 功能的发行版本（发布说明中注明包含 Local Email App V2）
在源码环境测试时应使用 `uv run --directory /path/to/mcp-email-server mcp-email-server stdio` 而非搭配 PyPI `@latest`

试试这样问

连接成功后，可以直接对 AI 助手这样说：

列出我配置的邮箱账户
搜索最近一周收到的邮件
帮我给 [email protected] 发一封邮件
把这封邮件移动到归档文件夹

使用场景

让 AI 助手代为搜索、整理收件箱中的邮件

通过自然语言指令起草并发送邮件

在多个邮箱账户之间统一管理邮件操作

详细介绍

mcp-email-server 是一个开源的模型上下文协议（MCP）服务器，支持通过 IMAP 和 SMTP 协议读取、搜索、整理和发送电子邮件，支持多账户，兼容 Windows、macOS 和 Linux。项目提供图形化配置界面（mcp-email-server ui）用于设置邮箱账户，并支持通过 uv/uvx 以 stdio 方式接入 MCP 客户端。1.0.0 版本引入了新的“本地邮件应用 V2”，采用 SQLite 托管存储凭据，并提供预览优先的 CLI 迁移工具，可将旧版 TOML/keyring 配置导入新方案；未迁移的旧配置会以兼容的 legacy 模式继续工作，无需强制迁移。