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 |