AI导哈

Thunderbird MCP服务器

一个为AI助手提供Thunderbird访问功能的服务器，支持邮件、联系人、日历和邮件过滤器的管理。

  • by mareurs
  • JavaScript
  • 本地部署
  • 2 星标
  • 更新于
在 GitHub 查看 mareurs/thunderbird-mcp

使用说明

雷鸟mcp

A. 模型上下文协议 服务器，让人工智能助手（克劳德等）访问雷鸟——电子邮件、联系人、日历和邮件过滤器。

AI assistant ──stdio──▶ thunderbird-mcp (Rust) ──HTTP :45678──▶ Thunderbird extension (XPCOM)

特性

类别 工具
邮件 get_recent_messages, search_messages, get_message, update_message, delete_messages, delete_messages_by_filter
编排 send_mail, reply_to_message, forward_message
文件夹 list_accounts, list_folders, create_folder, delete_folder
过滤器 list_filters, create_filter, update_filter, delete_filter, reorder_filters, apply_filters
联系人 search_contacts, list_address_books, create_contact, update_contact, delete_contact
日历 list_calendars, list_events, create_event

需求

  • 雷鸟 115或更高
  • 锈 稳定（用于构建二进制文件）
  • Linux （主要目标；macOS/Windows未测试）

安装

1.下载或构建

预建（推荐）： 抓取 mcp-server.xpi 和 thunderbird-mcp-linux-x86_64 从 最新版本.

或者，直接从安装扩展 雷鸟插件库 并且仅从该版本下载二进制文件。

从源代码构建：

git clone https://github.com/mareurs/thunderbird-mcp
cd thunderbird-mcp

cargo build --release          # builds ./target/release/thunderbird-mcp
./scripts/build.sh             # packages extension → ./dist/mcp-server.xpi

2.安装延长件

来自ATN（最简单）： 开放雷鸟→ 附加组件和主题 → 搜索“MCP服务器”→ 安装。

来自文件： 打开雷鸟→ 附加组件和主题 → 齿轮图标→ 从文件安装附加组件 → 选择 dist/mcp-server.xpi → 重新启动Thunderbird。

该扩展在上启动HTTP服务器 localhost:45678 并将身份验证令牌写入 ~/.thunderbird-mcp-auth.

3.配置您的AI客户端

创建 .mcp.json 在您的项目中（此文件为gitignored，请勿提交）：

{
  "mcpServers": {
    "thunderbird": {
      "type": "stdio",
      "command": "/absolute/path/to/thunderbird-mcp/target/release/thunderbird-mcp",
      "args": []
    }
  }
}

对于 克劳德代码，还添加 instructions 字段--请参见 文档/系统说明.md 对于推荐的内容。

运作原理

  1. Rust二进制文件从以下位置读取认证令牌 ~/.thunderbird-mcp-auth 在启动时。
  2. 它通过stdio公开一个MCP服务器，注册所有工具。
  3. 每个工具调用都转换为对扩展进行承载身份验证的HTTP POST。
  4. 该扩展使用Thunderbird的XPCOM/WebExtension API执行操作并返回JSON。
  5. Rust二进制文件对响应进行净化（去除控制字符）并将其返回给MCP客户端。

已知限制

  • IMAP过期 --文件夹内容可能会滞后于服务器，直到Thunderbird同步。如果结果看起来过时，请重试。
  • 垃圾邮件文件夹 --由于消息体中的控制字符，可能会导致JSON解析错误。避免直接阅读。
  • create_event --打开Thunderbird的事件对话框，而不是静默创建；需要用户确认。
  • apply_filters --异步；MCP响应在消息实际移动之前返回。
  • Gmail --跨标签复制邮件。始终范围 get_recent_messages / search_messages 到特定文件夹。

在中跟踪已知问题 GitHub问题.

发展

看 贡献.md 用于构建设置、代码结构和贡献指南。

路线图

看 ROADMAP.md.

致谢

这个项目的灵感来自 TKasperczyk/雷鸟mcp，原JavaScript/Node.js实现思路相同。Thunderbird扩展结构和HTTP API设计大量借鉴了这项工作。这个版本用Rust二进制文件取代了Node.js桥，以实现更精简的运行时依赖性。

许可证

麻省理工学院——见 许可证.

相关 MCP