mcpField
M
mcp-email-server

mcp-email-server

本地服务
github.com/ai-zerolab通信协作3713 天前更新
代码仓库

关于 mcp-email-server

mcp-email-server 是一个 MCP 服务，通过 IMAP 和 SMTP 实现邮件的读取、搜索、整理与发送。支持 Windows、macOS 和 Linux，并提供配置界面与命令行迁移工具。

主要功能

  1. 01通过 IMAP 读取与搜索邮件
  2. 02通过 SMTP 发送邮件
  3. 03整理邮件的工具
  4. 04提供配置界面管理邮箱账户
  5. 05支持从旧版配置迁移

适用场景

  1. 01让 MCP 客户端查询最近的邮件
  2. 02通过 Agent 发送邮件通知
  3. 03在多个邮箱账户之间进行管理

MCP 相关

该项目是 MCP 服务，向 MCP 客户端提供邮件读取、搜索、整理与发送的相关工具，并通过 stdio 传输运行。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "email-server": {
      "command": "npx",
      "args": [
        "-y",
        "@smithery/cli"
      ]
    }
  }
}
启动命令npx -y @smithery/cli

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
npm@smithery/cli

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

mcp-email-server

Release Build status codecov License

一个通过 IMAP 和 SMTP 读取、搜索、整理和发送电子邮件的 MCP 服务。

说明

1.0.0 版本推出了 Local Email App V2。更新软件包不会自动导入使用 PyPI 0.16.0 及更早版本创建的现有设置： 这些设置仍会以向后兼容的 legacy 模式保持启用，因此无需迁移。如果 您想使用新的托管存储，可以在方便时查看并导入这些设置。

mcp-email-server 支持 Windows、macOS 和 Linux。平台特定的文件系统与凭据存储详情请参阅 安全性。

现有安装的可选迁移

包含 Local Email App V2 的 @latest 版本提供了预览优先的 命令行迁移：

uvx mcp-email-server@latest config init \
  --database ~/.config/mcp-email-server/managed.sqlite3
uvx mcp-email-server@latest config import-legacy
uvx mcp-email-server@latest config import-legacy --apply
uvx mcp-email-server@latest config doctor

应用步骤会再次显示计划，并要求输入 IMPORT 进行确认。完整导入会选择托管模式；否则仍会选择现有的 legacy 设置。源 TOML 文件及其 legacy 密钥环条目均不会被修改。您也可以运行 uvx mcp-email-server@latest ui 并选择导入现有设置。成功导入后，请重启正在运行的 MCP 客户端。详情请参阅升级指南和导入故障排查。

快速开始

1. 配置电子邮件帐户

在此源代码检出目录中，使用 uv 运行配置界面：

uv sync
uv run mcp-email-server ui

对于发布说明中注明包含 Local Email App V2 的已发布版本，uvx mcp-email-server@latest ui 是等效的临时调用方式。

保持前台命令持续运行。在真正空白的安装环境中，经过身份验证的浏览器会话会在安全的本地默认位置准备私有帐户存储；如果已有 TOML 或环境配置，则会提供明确的导入审核选项，同时继续使用之前的设置。以帐户为先的界面只有电子邮件帐户和设置与帮助两个主要入口。先填写电子邮件地址和密码；界面会根据电子邮件域名填入常用连接设置，并允许编辑；发送邮件则是可选项。保存完整帐户后即可使用，无需单独激活。如有需要，可在已保存的帐户上使用密码与测试，然后重启 MCP 客户端以应用所选设置。

2. 配置 MCP 客户端

stdio 使用的发行版本必须与界面使用的版本一样支持 V2。对于已发布的 V2 版本，请将以下服务定义添加到 MCP 客户端：

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

更新配置后，重启 MCP 客户端。在发布前测试此源代码检出目录时，请调用 uv run --directory /absolute/path/to/mcp-email-server mcp-email-server stdio，不要将托管目录与 PyPI @latest 配对使用。

3. 验证连接

让客户端列出已配置的电子邮件帐户或最近的邮件。

其他配置方式

有关基于 SQLite 的托管命令行工作流、Windows 和 POSIX 存储边界、无头环境、多个账户、自定义 TLS 设置和环境变量配置，请参阅文档。1.6.2 及更高版本还发布了 Linux amd64/arm64 镜像，地址为 ghcr.io/wh1isper/mcp-email-server；请参阅容器说明。

文档

开发

请参阅 CONTRIBUTING.md。

许可证

本项目根据 LICENSE 的条款授权。

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。