← 返回目录
M

MCP Email Server

社区
通过 IMAP 和 SMTP 读取、搜索、整理和发送邮件的多账户 MCP 服务器
GitHub 源仓库 ↗
★ 316 Stars 分类 · 其他 非常热门 源版本 fe4b6c8647e3
60FMRS · C
可靠性
8/20
安全与权限
11/20
维护活跃度
15/20
文档质量
14/20
安装易用性
12/20

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

查看 FMRS 评分方法 →

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 模式继续工作,无需强制迁移。

工具能力

暂未整理工具清单。

安装接入

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) 让客户端列出已配置的邮箱账户或最近邮件以验证连接。

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

选型与风险

适合谁

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

不适合谁

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

所需权限

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

风险与副作用

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

常见排障

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

使用场景

让 AI 助手代为搜索、整理收件箱中的邮件
通过自然语言指令起草并发送邮件
在多个邮箱账户之间统一管理邮件操作

支持客户端

暂未确认支持的客户端。