fastmail-mcp
MadLlama25/fastmail-mcp加载项目详情…
本应用为开源项目，仅供学习研究，请遵守其开源协议。
微信扫码咨询客服
POMOAI — 让开源 AI 即刻运行
加载项目详情…
本应用为开源项目，仅供学习研究，请遵守其开源协议。
凌晨两点，工程师小张在处理一个紧急 bug，需要查阅三天前某位同事发来的邮件来还原上下文。他不想打开邮箱客户端打断思路，只想在一个 AI 对话窗口里直接问："帮我找一下上周三王工发的那封关于部署方案调整的邮件。"——这种体验，Fastmail MCP Server 正在尝试实现。
Fastmail MCP Server 是一个非官方的 Model Context Protocol（MCP）服务器，它将 Fastmail 的 JMAP/CalDAV/WebDAV API 封装为一组标准化的工具（tools），让 AI 助手（如 Claude Desktop）能够直接读取、搜索、发送邮件，以及管理日历和联系人。
注：Fastmail 是一个以隐私保护著称的邮件服务商，采用开放的 JMAP 协议作为其核心 API。本项目为社区作品，与 Fastmail 无官方隶属关系。
该项目由独立开发者 Jeremy Gill 创建并维护，仓库创建于 2025 年 6 月，遵循 MIT 开源协议。截至目前已获得 125 颗 Stars、47 个 Forks，在 MCP 相关生态中属于活跃度较高的工具型项目。
项目的诞生背景非常清晰：随着 AI 助手（Claude、ChatGPT 等）逐渐成为程序员日常工作的核心工具，用户希望 AI 能够直接访问自己的邮件、日历数据来完成信息检索、任务规划等操作，而不是让 AI 在一个封闭的沙箱里工作。Fastmail 提供了开放的 JMAP API，但缺乏与主流 AI 助手的原生集成——这个 Gap 正是 fastmail-mcp 要填补的。
fastmail-mcp 的整体架构可以概括为"一个主入口 + 多个专业客户端"：
┌──────────────────────────────────────────────────────┐
│ MCP Server (index.ts) │
│ Server + StdioServerTransport + MCP SDK │
├──────────┬──────────┬──────────────┬─────────────────┤
│ JmapClient│Contacts- │ CalDAV- │ WebDAV- │
│ (邮件) │Calendar- │ Calendar- │ Files- │
│ │Client │ Client │ Client │
├──────────┴──────────┴──────────────┴─────────────────┤
│ FastmailAuth (统一认证) │
├──────────────────────────────────────────────────────┤
│ JMAP API (邮件) / CalDAV (日历) / WebDAV (文件) │
└──────────────────────────────────────────────────────┘
核心技术栈：
@modelcontextprotocol/sdk v1.29.0tsdav 库）源码结构：
| 文件 | 职责 |
|---|---|
index.ts | MCP 服务器主入口，路由分发，工具注册（最核心，约 110KB） |
jmap-client.ts | 邮件核心：列表、搜索、读取、发送、附件 |
caldav-client.ts | 日历 CRUD，recurrence 处理（约 57KB，最大文件） |
contacts-calendar.ts | 联系人管理 |
webdav-files-client.ts | WebDAV 文件操作 |
auth.ts | Fastmail API Token 认证管理 |
coerce.ts | 参数校验与敏感信息脱敏 |
url-validation.ts | URL 安全校验（防止 SSRF） |
| 维度 | 评估 |
|---|---|
| 安装难度 | 低：npm install && npm run build，无编译依赖 |
| 配置难度 | 中：需从 Fastmail Web 界面手动申请 API Token |
| 使用门槛 | 高：需要 AI 助手支持 MCP 协议（如 Claude Desktop） |
| 认证安全 | 好：支持多环境变量名匹配，凭证自动脱敏输出 |
| 隐私风险 | 需评估：AI 助手访问邮箱数据涉及隐私，用户需明确授权 |
在 Claude Desktop 中配置方式（通过 .mcp.json 文件），本质上是一个 JSON 配置声明，将 fastmail-mcp 注册为 Claude Desktop 的 MCP 服务器之一。
fastmail-mcp 代表了一个正在兴起的技术趋势：AI 助手与个人数据源的深度集成。随着 MCP 协议的成熟和推广，我们可能会看到更多类似的"数据桥接器"出现——让 AI 能够访问用户真实的数据资产。
这种模式也带来了新的隐私和安全讨论：AI 助手访问邮件意味着什么级别的数据泄露风险？凭证如何安全管理？这些都是 fastmail-mcp 这类工具无法回避的问题。
fastmail-mcp 是一个设计清晰、实现扎实的 MCP 服务器，适合以下场景：
不适合：无 MCP 支持的 AI 助手用户、非技术用户（配置门槛较高）。
项目信息：MadLlama25/fastmail-mcp | ⭐ 125 | 🍴 47 | MIT License | TypeScript | 2025-06-15 首次创建