MCP for Thunderbird

Thunderbird 的 MCP

Thunderbird 的 MCP 可让电脑上的 AI 应用在你设定的限制范围内处理 Thunderbird 中的邮件。

Claude Desktop、Claude Code、Codex 和 Cursor 等 AI 应用通过开放标准 Model Context Protocol（MCP）连接外部工具。Thunderbird 的 MCP 为它们提供一组邮件工具：搜索邮件、阅读邮件、整理收件箱，以及为你撰写草稿供你检查。你可以选择它们能使用哪些账户、能执行哪些操作，也可以随时通过 Thunderbird 工具栏暂停它们。

Thunderbird 的 MCP 可与 Thunderbird 配合使用。它并非由 Mozilla 或 MZLA Technologies（Thunderbird 的开发方）制作、认可或关联。

工作原理

Thunderbird 的 MCP 由两部分组成：

• 扩展，安装在 Thunderbird 中。它通过 Thunderbird 的标准扩展接口处理邮件，并保存你的设置、活动日志和暂停开关。
• 主机程序，安装在同一台电脑上的小型程序。Thunderbird 启动时会启动它，关闭时会停止它。AI 应用与主机程序通信，主机程序再将请求传递给扩展。

Thunderbird 已保存你的邮箱登录信息和邮件副本，因此 Thunderbird 的 MCP 从不会索要邮件密码。所有通信都不会经过外部服务器：扩展、主机程序和 AI 应用只在你的电脑上相互通信。之后，AI 应用本身会像处理你提供的其他内容一样，将它读取到的内容发送给其供应商。PRIVACY.md 详细说明了数据的具体流向。

AI 应用可以执行的操作

这些工具分为多个组，你可以在扩展的选项中逐组启用或关闭。关闭某个组后，其中的工具将不会提供给 AI 应用。

组	工具	功能
读取	mail_accounts、mail_folders、mail_search、mail_read、mail_thread、mail_attachment、mail_filter_suggest	列出账户和文件夹；搜索邮件；阅读一封邮件；列出对话中的邮件；将附件保存到你选择的文件夹；描述邮件筛选条件，供你创建筛选器。
整理	mail_mark、mail_tag、mail_move、mail_archive、mail_trash	标记为已读或加旗标；添加或移除标签；移动或复制到其他文件夹；归档；移至废纸篓。
草稿	mail_draft、mail_compose	将新邮件、回复或转发邮件保存到草稿；打开已填写内容的撰写窗口，供你检查并发送。
联系人	mail_contacts	在通讯录中查找联系人。
发送	mail_send	不打开窗口发送邮件，且只能发送给你已列出的收件人。默认关闭，需由你启用。

无法执行的操作

• 永久删除邮件。 整理工具可以将邮件移至废纸篓，但没有工具会清空废纸篓或垃圾邮件文件夹、删除文件夹或更改账户设置。
• 编辑 Thunderbird 的邮件筛选器。 Thunderbird 不提供可供扩展修改筛选器的接口，因此 mail_filter_suggest 会列出操作步骤，供你在 Thunderbird 的“邮件筛选器”窗口中执行。
• 日历和任务。 Thunderbird 没有适用于它们的稳定扩展接口。
• 与网页浏览器中的 AI 应用配合使用，例如浏览器标签页中的 ChatGPT 或 claude.ai。这些应用通过互联网服务器访问工具，而 Thunderbird 的 MCP 只在你自己的电脑上侦听。
• 在 Thunderbird 关闭时运行。 主机程序仅在 Thunderbird 运行时运行。如果 AI 应用在此期间发出请求，它会收到“Thunderbird is not running”的提示。
• 在 Thunderbird for Android 上运行。

安全默认设置

• 只有勾选后才会使用账号。 首次运行时，设置页面会询问 AI 应用可以使用哪些账号。默认情况下不会勾选任何账号。
• 建议选择“读取和整理”。 撰写邮件和使用联系人功能默认关闭，需由你启用。
• 不会发送邮件。 使用默认设置时，AI 应用执行的任何操作都无法发送邮件或永久删除内容。草稿和撰写窗口会将是否发送的决定权留给你。除非你在选项中启用直接发送、列出允许发送邮件的地址或域名，并在 Thunderbird 自带的权限提示中允许，否则直接发送始终处于关闭状态。
• 搜索结果不会包含邮件正文。 搜索结果只是定位信息：发件人、主题、日期、文件夹和标记。AI 应用只有在请求读取某封邮件时，才会读取该邮件的正文。
• 邮件正文会被标记为不可信内容。 系统会尽可能移除隐藏文本、脚本和不可见字符，并将保留的内容放入一个区块，告知 AI 应用这些内容是发件人提供的数据，而不是指令。
• 仅限本地，并使用访问密钥。 主机只在 127.0.0.1 上监听，且只响应携带访问密钥的请求。设置过程中连接的 AI 应用会自行读取密钥，因此你无需手动复制。
• 你可以查看并停止它。 工具栏按钮会显示 MCP for Thunderbird 的连接状态：已连接、已暂停或未连接。菜单中的“暂停”按钮会拒绝所有请求，直到你恢复运行。选项中的活动日志会列出最近 500 条请求（时间、应用、工具和结果），不包含邮件正文或地址。

SECURITY.md 详细说明了威胁和防护措施，包括其局限性。

支持的版本

• Windows、macOS 和 Linux 上的 Thunderbird 153 或更高版本。更早的版本缺少 MCP for Thunderbird 所需的扩展接口，无法在不打开窗口的情况下保存草稿。
• 已在 Linux 上的 Thunderbird ESR 153.4 中测试；CI 中运行的端到端测试还覆盖了 Windows 上的 Thunderbird 158 和 macOS 上的 Thunderbird 157。
• 账号类型：已使用 IMAP 测试。MCP for Thunderbird 只使用 Thunderbird 的通用邮件接口，因此，Thunderbird 支持的其他账号类型（例如通过 IMAP 使用 Gmail 和 Microsoft 365）应该表现相同。尚未测试通过 Thunderbird 内置 Exchange 支持添加的 Exchange 账号。
• Linux：从 thunderbird.net 下载的 Thunderbird，以及非 Snap 或 Flatpak 的发行版软件包均可正常使用。Snap 版（当前 Ubuntu 中通过 apt install thunderbird 安装的版本）尚未测试，Flatpak 版不受支持；请参阅 INSTALL.md。

快速开始

1. 从 GitHub releases page 下载适用于你系统的主机并安装。Windows 和 macOS 会警告该软件来自未知发布者；INSTALL.md 介绍了如何继续。在 Linux 上，然后以你自己的用户身份运行 mcp-for-thunderbird setup。
2. 从同一个发布页面下载并在 Thunderbird 中安装扩展：下载 mcp-for-thunderbird-<version>.xpi，打开 ≡ 菜单，选择 附加组件和主题，然后点击齿轮按钮，再选择 从文件安装附加组件…，并选中该文件。（后续将提供 addons.thunderbird.net 上的扩展列表，以便自动更新扩展。）
3. 扩展会打开设置页面：勾选 AI 应用可以使用的账号，选择允许它们执行的操作，并勾选要配置的 AI 应用。
4. 重启 AI 应用，然后向它提问，例如：“今天我的收件箱里有什么需要处理的内容？”

INSTALL.md 包含各系统的完整安装步骤、连接其他 AI 应用的方法、升级和卸载说明。

已知限制

• 文本搜索需要邮件存储在你的电脑上。 搜索邮件正文时，只会找到 Thunderbird 已下载完整正文的邮件。对于 IMAP 账户，请在账户的“同步与存储”设置中启用“将此账户的邮件保存在这台电脑上”。
• 文本搜索区分大小写，因为 Thunderbird 的搜索就是如此。结果按时间从新到旧排列；搜索时间较长时，会在约 10 秒后停止并返回已找到的结果，同时提示如何缩小搜索范围。
• 如果没有剩余时间进行检查，搜索结果中的“有附件”状态可能未知。
• 每个请求只有一个时间预算。 一次更改多封邮件的请求（标记、添加标签、移动）如果遇到 Thunderbird 运行缓慢，会报告哪些邮件已处理、哪些失败。
• 回复和转发草稿会保存到“草稿”文件夹，并保留邮件线程关系。发送后，Thunderbird 会根据账户自身的设置归档已发送副本；此功能尚未在所有账户类型上测试。
• 直接发送仅接受简单地址：@ 前只能包含字母、数字和 . _ + -，且域名必须是纯文本。其他地址请先撰写草稿。SECURITY.md 说明了原因。
• 该主机程序尚未经过代码签名，因此 Windows 和 macOS 在安装时会发出警告。发布页面上的扩展也未签名；Thunderbird 可以从文件安装未签名扩展，而该扩展一旦在 addons.thunderbird.net 上架，就会由其签名。

链接

• INSTALL.md：安装、连接 AI 应用、升级和卸载
• SECURITY.md：威胁模型、防护措施、已知限制以及如何报告漏洞
• PRIVACY.md：数据的去向
• CONTRIBUTING.md：构建、测试和贡献
• docs/PLATFORMS.md：各系统上的测试情况

支持本项目

MCP for Thunderbird 是 Noiz 提供的免费软件。如果它对你有用，支持其开发的主要方式是捐赠 Monero（XMR）：

44BtMn9izxH8mK2yFbSdY6Di7TNobkLbnHdZ6gZQjukCME5vsNhtPRtH4TcVkDHKHLhSpAJbsjv8gCdYuSZVMpXgMkUC1hV

你也可以通过报告错误、提交修复或为代码库点星来提供帮助。

许可与致谢

MCP for Thunderbird 由 Wade J. Beckett（GitHub 上的 wadejbeckett）依据 Mozilla Public License 2.0 发布（LICENSE）。

扩展的部分内容以及 SECURITY.md 中的威胁模型改编自 Vitalii Ionov 的 thunderbird-cli，并依据 MIT License 使用。NOTICE 列出了相关文件并保留了该许可。主机程序链接了依据 MIT 和 BSD 许可发布的 Go 库；THIRD_PARTY_LICENSES 附有这些库的声明，并包含在每个主机程序包中。

Thunderbird 是 Mozilla Foundation 的商标。Claude、Codex 和 Cursor 是 Anthropic、OpenAI 和 Anysphere 的产品名称；这里提及这些名称仅用于说明 MCP for Thunderbird 可与哪些应用配合使用，这些公司均未制作、认可或关联本项目。