Fastmail MCP 服务器（非官方）

用于 Fastmail 集成的非官方模型上下文协议 (MCP) 服务器。它公开了一个 execute 工具，充当经过验证的 JMAP 代理——LLM 编写原始 JMAP 方法调用，服务器负责处理验证、身份验证和响应清理。

设置说明

1. 获取您的 Fastmail API 令牌

1. 登录 Fastmail

2. 前往 Settings（设置）→ Privacy & Security（隐私与安全）→ API tokens（API 令牌）

3. 点击 New API token（新建 API 令牌）

4. 为其命名（例如 "Claude MCP"）

5. 选择所需的范围：Mail（根据需要选择读/写）

6. 复制生成的令牌

2. 配置 Claude Code

将以下内容添加到您的 Claude Code MCP 设置中（~/.claude/claude_desktop_config.json 或项目 .mcp.json）：

{
  "mcpServers": {
    "fastmail": {
      "type": "url",
      "url": "https://fastmail-mcp.i11v.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_FASTMAIL_API_TOKEN"
      }
    }
  }
}

安全提示： 请妥善保管您的 API 令牌。切勿将其提交到版本控制系统中。请考虑使用环境变量或密钥管理器。

可用工具

execute

针对 Fastmail 执行 JMAP 方法调用。接受一个 JMAP 方法调用三元组数组 [methodName, args, callId]。

输入：

{
  "methodCalls": [
    ["Email/query", {
      "filter": { "inMailbox": "INBOX_ID" },
      "sort": [{ "property": "receivedAt", "isAscending": false }],
      "limit": 10
    }, "call-0"],
    ["Email/get", {
      "ids": { "resultOf": "call-0", "name": "Email/query", "path": "/ids" },
      "properties": ["from", "subject", "receivedAt", "preview"]
    }, "call-1"]
  ]
}

服务器执行的操作：

• 验证结构、方法名称和卫生规则

• 自动注入 accountId

• 发送到 Fastmail 的 JMAP API

• 去除协议噪声（state、queryState、canCalculateChanges 等）

• 返回清理后的 methodResponses

允许的 JMAP 方法：

• Core/echo

• Mailbox/get, Mailbox/query, Mailbox/queryChanges, Mailbox/set

• Email/get, Email/query, Email/queryChanges, Email/set

• Thread/get

• SearchSnippet/get

• Identity/get

• EmailSubmission/get, EmailSubmission/query, EmailSubmission/set

验证规则：

• 每个 /get 调用（Mailbox/get 和 Identity/get 除外）必须包含一个 properties 数组

• 每个 /query 调用必须包含一个 limit

• /get 调用中的 ids: null 将被拒绝（请先使用 /query）

• 破坏性操作（destroy, EmailSubmission/set）将返回错误，要求用户确认

compose_email (MCP 应用)

打开交互式邮件撰写表单。可选择预填字段（收件人、抄送、密送、主题、正文）。在支持 MCP 应用的主机上，渲染带有发送和保存草稿按钮的内联撰写 UI。在其他主机上回退为结构化文本。

输入：

{
  "to": "recipient@example.com",
  "subject": "Hello",
  "body": "Message text..."
}

read_email (MCP 应用)

在富文本阅读视图中显示邮件的全部内容。通过 JMAP ID 获取邮件，并渲染标题、经过清理的正文以及操作按钮（回复、全部回复、转发）。在不支持 MCP 应用的主机上回退为结构化文本。

输入：

{
  "emailId": "M1234abcd"
}

可用资源

支持资源的 MCP 客户端会自动接收 Fastmail 技能——一组教导 LLM 如何驱动 execute JMAP 工具的 markdown 文件。支持资源优先级的客户端将首先加载 SKILL.md 并延迟加载其链接。

所有资源均使用 file:///fastmail-skill/<path> URI 方案和 text/markdown MIME 类型。标记为 audience: ["assistant"]。

API 端点

• POST /mcp - MCP 协议端点

• GET /health - 健康检查端点

环境变量

将 .env.example 复制到 .env.development.local 并填写值：

cp .env.example .env.development.local

开发

pnpm install   # Install dependencies
pnpm dev       # Run local dev server (wrangler)
pnpm check     # Run all checks (typecheck + lint + fmt + test)
pnpm run deploy:prod  # Deploy to Cloudflare

这是一个非官方的社区项目，与 Fastmail 无关。

源代码和问题反馈：GitHub