TKasperczyk/thunderbird-mcp

Thunderbird MCP – 面向Thunderbird的AI友好桥接

这是什么 – 一个Thunderbird附加组件，运行一个本地HTTP服务器和一个Node.js 桥接器，使得任何兼容模型上下文协议（MCP）的AI助手（Claude、GPT、本地LLM等）都能直接在Thunderbird内读取、编写、整理和搜索邮件、联系人、过滤器和日历。

重要性 – Thunderbird没有官方API。没有这个桥接器，AI无法看到收件箱或帮助起草回复。该扩展通过MCP安全地公开了约40个工具（列出账户、搜索消息、获取完整消息正文、发送邮件、管理过滤器、联系人、日历事件等），让AI代理像人类一样操作邮箱。

工作原理

• 附加组件捆绑了一个HTTP服务器，监听localhost:8765‑8774，并使用每会话认证令牌。
• 一个Node.js脚本（mcp-bridge.cjs）将标准的MCP stdio协议转换为本地HTTP API，通过连接文件发现端口/令牌，并处理MCP生命周期调用（initialize、ping），这样AI即使在Thunderbird加载完成前也能连接。
• 所有通信都保持在本地机器上；不需要外部网络流量。

主要能力

领域	工具（精选）	你能做什么
邮件	listAccounts、listFolders、searchMessages、getMessage(s)、displayMessage、updateMessage、deleteMessages、createFolder …	浏览账户、按标题/正文搜索、以Markdown/文本/HTML格式阅读消息、在界面中打开、标记已读/未读、添加标签、移动/复制、创建/删除文件夹、清空垃圾箱/垃圾邮件。
编写	sendMail、saveDraft、replyToMessage、forwardMessage	打开审查窗口，或（在禁用*阻止skipReview*安全标志后）直接发送、保存草稿、带正确线程回复、带附件转发。
过滤器	listFilters、createFilter、updateFilter、deleteFilter、reorderFilters、applyFilters	列出、创建、编辑、重新排序和手动运行邮件过滤器；除非明确启用，否则安全默认阻止自动转发/回复操作。
联系人	searchContacts、getContact、createContact、updateContact、deleteContact	搜索、读取、创建、修改和删除地址簿条目。
日历	listCalendars、createEvent、listEvents、updateEvent、deleteEvent	列出日历、创建事件（默认审查窗口）、查询带重复展开的事件、编辑或删除它们。

安全与隐私

• 仅本地 – 服务器绑定到localhost并使用每会话令牌；数据不会离开你的计算机。
• 默认审查 – 除非关闭*阻止skipReview*首选项，否则发送邮件、创建带与会者的事件以及自动过滤器操作都会被阻止。
• 加密邮件 – 除非选择加入，否则禁用对加密消息的访问。
• MIME和大小限制 – 内联图像仅作为MCP图像块包含（每个最大1 MiB，总计4 MiB）。超过2 MiB的HTML正文会被截断并带有明确通知。
• 严格验证 – 标签键、过滤字符串、联系人和日历与会者根据Thunderbird自身的规则进行验证；格式错误的输入会导致整个调用失败，而不是静默纠正。

典型工作流程

1. 在Thunderbird中安装附加组件。
2. 启动桥接器（node mcp-bridge.cjs）或让桌面客户端启动它。
3. 一个AI模型（例如Claude）通过MCP连接，接收认证令牌和端口。
4. 模型调用searchMessages等工具查找相关邮件，用getMessage阅读，并用sendMail（禁用skipReview后）起草回复。
5. 所有操作都在Thunderbird内执行，保留你现有的账户、签名和文件夹结构。

谁可能使用 – 开发需要深度邮箱访问权限的AI助手的开发者、希望LLM帮助筛选电子邮件的重度用户，或任何在注重隐私、本地托管的堆栈上尝试“AI作为个人助理”的人。

---

结论 – Thunderbird MCP是一个真正的开源桥接器，为AI模型提供对Thunderbird邮件、联系人、过滤器和日历的具体、文档完备的控制，同时将所有内容保持在设备上并由合理的默认安全设置保护。