← 返回目录

Atomic-Mail MCP

社区

为 AI 代理提供可编程的电子邮箱

查看安装方法 ↓ 横向对比 GitHub 源仓库 ↗

分类: 其他
Stars: ★ 265 热门
传输方式: stdio（本地进程）
运行环境: Node.js 20+
凭据: 无需凭据
许可证: MIT
最近提交: 14 天前
工具数: 3

56FMRS · C

Atomic Mail 为 AI 代理提供自主邮箱服务，基于 JMAP 标准，使用工作量证明注册，支持无人工干预的邮件操作。适合需要自动化处理邮件的场景，但需注意安全性和 alpha 阶段的限制。

最强项 · 文档质量 13/20 最弱项 · 可靠性 8/20

可靠性

8/20

安全与权限

13/20

维护活跃度

12/20

文档质量

13/20

安装易用性

10/20

查看各项评分依据

可靠性 8/20: 证据显示：清单格式规范（引用合法 schema、stdio 传输、带 isSecret 标记的环境变量、固定 npm 包版本 0.3.4），且声明的工具面（register、jmap_request、help）在清单与 README 之间基本一致，happy path 合理可行。扣分项：清单声明的 npm 包为 @atomicmail/mcp-modelcontextprotocol，而 README 安装命令却是 @atomicmail/mcp-github，存在包名矛盾；本文只提供 README 与清单，未提供可核实的 CI 工作流、已提交测试或服务端源码，因此无法验证初始化/工具列表握手、错误处理与边界情况。按静态校准，缺少执行证据使本项评分下降，包名矛盾使其低于 10 分基线。
安全与权限 13/20: 证据显示：未发现红线问题——示例中无真实令牌、无代码级窃取/隐蔽外传迹象、无不可逆破坏性默认行为；设计上的数据流已披露（PoW 认证服务、JMAP API、本地凭据目录 ~/.atomicmail/）。正面项：ATOMIC_MAIL_API_KEY 标记为 isSecret，凭据文件以 0600 权限写入，README 明确警告入站邮件不可信并要求仅从 @atomicmail 命名空间安装，权限边界与敏感信息标记清晰。扣分项：PoW 协议与密钥生命周期仅作高层描述，密钥轮换/吊销与安全联系渠道未记录；对发送邮件等有副作用操作未提供文档化的确认步骤（尽管‘完全自主运行’是产品定位，但不可撤销的发送动作缺少确认设计）；数据流向披露完整但运维层面的安全流程不完整。
维护活跃度 12/20: 证据显示：仓库含 MIT 许可证、未被归档、开放 issue 为 0，清单和发布徽章表明存在版本化发布路径（0.3.4），且维护了 MCP、AgentSkill、LangChain、Dify、ClawHub 等多种集成面，暗示持续活跃与清晰的版本管理。扣分项：提交频率、依赖更新节奏、issue 响应情况无法从给定的静态资料中验证；文件结构列表中只有 CONTRIBUTING.md 和 LICENSE，没有 SECURITY.md 或文档化的安全响应渠道；CI/发布徽章属于不可信证据，不能作为活跃度的直接依据。
文档质量 13/20: 证据显示：README 分层且内容充实——提供多宿主快捷安装、按目标分类的文档索引表、示例工作流、内置 JSON 预设、内嵌速查表的 help 工具，并披露了 alpha 状态、100MB 配额与严格速率限制，错误信息含提示的设计也值得肯定。扣分项：安装示例与清单包名矛盾（@atomicmail/mcp-github vs @atomicmail/mcp-modelcontextprotocol），会直接误导用户；免费额度之外的定价/成本结构未说明；所引用的 docs/ 各文档内容无法从给定材料中核实，故障排查深度只能以 README 本身所展示的内容为限。
安装易用性 10/20: 证据显示：按 README 描述，安装步骤很短——在宿主配置中粘贴基于 npx 的 mcpServers JSON 块并重启宿主，随后代理通过 PoW 自助注册，无需人工填密钥；环境变量均可选，且提供了完整的环境变量说明；stdio + npx 具备跨平台潜力。扣分项：README 的安装包名与清单声明的包名不一致，用户无法确定哪个是权威包，路径存在歧义且脆弱；安装依赖外部认证服务可用性、PoW 协议与 Node.js 20+ 环境；按静态校准，缺少可核实的 CI 工作流和已提交测试，本项不能超过 15 分，包名歧义进一步压低得分。

静态评测 · 未实际运行收录于 2026-08-07

查看 FMRS 评分方法 →

选型与风险

能访问什么访问网络修改第三方账户数据

适合谁

希望 AI 代理拥有独立邮箱并自动处理邮件的工作流。
需要无人工干预的自动化邮件操作，特别是与 Claude、Codex、Cursor 等代理集成。
希望利用 JMAP 标准协议，避免供应商锁定的开发者。

不适合谁

需要人工审核每一封邮件的场景，因为代理可以自主发送和接收邮件。
对邮件投递率要求极高，且不想依赖第三方服务的企业关键场景（虽然服务声称有投递优化）。
完全离线或希望完全控制邮件基础架构的组织。

所需权限

读写本地 credential 文件（默认为 `~/.atomicmail/credentials.json`）。
网络访问：与 Atomic Mail 的认证服务和 JMAP API 通信。
环境变量：可能需要 `ATOMIC_MAIL_API_KEY` 等，用于跳过注册。

风险与副作用

API 密钥存储在本地文件中，若泄露可能被滥用。
邮件内容被视为不可信输入，代理可能被诱导执行恶意指令（如钓鱼邮件）。
服务处于 alpha 阶段，有存储配额和速率限制，可能不稳定。
依赖外部服务，若 Atomic Mail 服务中断，代理邮件功能将受影响。

安装接入

准备工作

运行环境：Node.js 20+

ATOMIC_MAIL_API_KEY 可选密钥可选，已有的 API key，可跳过 PoW 注册；来自 Atomic Mail 注册成功后保存的凭证。

其他可选配置项（4 个）

ATOMIC_MAIL_CREDENTIALS_DIR 可选可选，覆盖默认凭证目录（~/.atomicmail/）；无需从外部获取。

ATOMIC_MAIL_AUTH_URL 可选可选，覆盖认证服务的基础 URL；一般无需设置。

ATOMIC_MAIL_API_URL 可选可选，覆盖 JMAP API 的基础 URL；一般无需设置。

ATOMIC_MAIL_INBOX_DOMAIN 可选可选，当 inboxId 不带 @ 时使用的默认收件箱域名（默认 atomicmail.ai）。

在 MCP 客户端配置中添加以下 JSON（如 Claude Desktop：claude_desktop_config.json）：将 command 设置为 npx，args 设置为 ["-y", "@atomicmail/mcp-github"]。
重启客户端。
让代理创建一个邮箱（例如，提示代理阅读 https://atomicmail.ai 并注册）。

claude_desktop_config.json

{
  "mcpServers": {
    "atomicmail": {
      "command": "npx",
      "args": [
        "-y",
        "@atomicmail/mcp-github"
      ]
    }
  }
}

以 Claude Desktop 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

{
  "servers": {
    "atomicmail": {
      "command": "npx",
      "args": [
        "-y",
        "@atomicmail/mcp-github"
      ]
    }
  }
}

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

claude mcp add atomicmail -- npx -y @atomicmail/mcp-github

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

在 MCP 客户端的工具列表中确认出现 register、jmap_request 和 help 三个工具；也可以直接让 agent 调用 help，如返回使用说明即说明连接正常。

常见排障

检查是否安装了 Node.js 20+ 或 Deno 2.7+。
确认 MCP 客户端配置正确，并重启主机。
查看 `~/.atomicmail/credentials.json` 是否存在且权限为 0600。
如果注册失败，尝试删除 `~/.atomicmail` 目录后重新注册。
使用 `help` 工具获取内置的故障排除指南。

试试这样问

连接成功后，可以直接对 AI 助手这样说：

帮我在 Atomic Mail 注册一个 @atomicmail.ai 收件箱，用户名用 myagent
用 jmap_request 列出我收件箱里的最新邮件
用预设 send_mail 给 [email protected] 发一封测试邮件
调用 help 看看有哪些可用的 JMAP 预设和示例

工具能力 3

注册一个新的 Atomic Mail 邮箱并获取 API 密钥。

jmap_request 写入

发送 JMAP 请求，用于读取、发送、回复邮件等操作。

help 只读

显示嵌入的文档、预设和故障排除信息。

使用场景

让 AI 代理自动订阅新闻简报、阅读并整理每日摘要。

代理自动监控支持邮箱并回复常见问题，仅升级疑难问题给人工。

代理自动发送调查问卷邮件、跟进回复并汇总结果。

支持客户端

Claude Desktop

Claude Code

Codex

GitHub Copilot

Cursor

Kilo Code

依据项目文档列出，未经本站实测。

详细介绍

Atomic Mail 是一个专为自主 AI 代理设计的电子邮件服务提供商。代理可以通过 JMAP 标准协议注册并管理自己的 @atomicmail.ai 邮箱，无需人工干预。它采用工作量证明（PoW）进行注册，防止滥用，并提供 MCP、CLI、AgentSkill 等多种集成方式。该项目包含 MCP 服务器、CLI 工具以及 Dify、ClawHub 等集成。