AI导哈

邮件搜索与阅读服务

一个通过Fastmail JMAP API提供邮件搜索和阅读功能的MCP服务器。

  • by AdamIsrael
  • Rust
  • 本地部署
  • 更新于
在 GitHub 查看 AdamIsrael/mcp-fastmail

使用说明

mcp快件

MCP（模型上下文协议）服务器，通过 快速邮件 JMAP API。

先决条件

  • 锈1.85+（2024年版）
  • 带有API令牌的Fastmail帐户（在设置中创建一个→ 隐私和安全→ 管理API令牌）

建筑

cargo build --release

二进制文件将位于 target/release/mcp-fastmail.

配置

服务器从以下位置读取TOML配置文件 $MCP_FASTMAIL_CONFIG 如果设置，否则 $HOME/.config/mcp-fastmail/config.toml.

api_token = "fmu1-..."
环境变量 默认值 描述
MCP_FASTMAIL_CONFIG $HOME/.config/mcp-fastmail/config.toml TOML配置文件的路径
RUST_LOG （关闭） 日志级别（例如。 info, debug)--日志转到stderr

使用Claude代码

添加到您的 .mcp.json:

{
  "mcpServers": {
    "fastmail": {
      "command": "/path/to/mcp-fastmail"
    }
  }
}

工具

search

使用特定字段过滤器搜索电子邮件。至少需要一个搜索筛选器。返回按日期排序的匹配电子邮件（最新的第一个）。

参数 类型 必填 说明
query string no 常规搜索查询（从、到、cc、bcc、主题和正文搜索）
from string no 按发件人姓名或电子邮件地址筛选
to string no 按收件人姓名或电子邮件地址筛选
subject string 否 按主题行筛选
body string 否 按正文内容筛选
after string no 仅返回在此日期或之后收到的电子邮件（ISO 8601，例如。 "2025-01-01T00:00:00Z")
before string no 仅返回在此日期之前收到的电子邮件（ISO 8601，例如。 "2025-12-31T23:59:59Z")
has_attachment boolean 否 仅返回带附件的电子邮件
limit integer no 最大结果数（1-50）。默认值为10。
position 整数 否 分页时基于0的偏移量。默认为0。

过滤器与AND相结合。例如， from: "alice" + subject: "invoice" 返回来自Alice的邮件，邮件主题中包含“发票”。

list_emails

列出收件箱中的电子邮件，按日期排序（最新的优先）。使用 position 用于分页。

参数 类型 必填 说明
limit integer no 最大电子邮件数（1-50）。默认值为10。
position 整数 否 分页时基于0的偏移量。默认为0。

get_email

通过ID获取特定电子邮件的完整内容（由返回 search 或 list_emails).

参数 类型 必填 说明
id string yes 要检索的电子邮件ID

相关 MCP