mcpField
S
smails

smails

本地服务
smails.dev通信协作3918 周前更新
代码仓库访问官网

关于 smails

smails 是一个面向人类和 AI Agent 的一次性邮箱服务，可通过命令行或 MCP 服务使用。它适合需要接收验证码等邮件的场景，无需注册即可创建临时邮箱。

主要功能

  1. 01命令行创建与管理一次性邮箱
  2. 02列出、读取与删除邮件
  3. 03AI Agent 可自行创建邮箱
  4. 04无需注册

适用场景

  1. 01让 AI Agent 接收注册验证码
  2. 02在终端临时收取测试邮件
  3. 03在 MCP 客户端中读取验证邮件

MCP 相关

该项目是 MCP 服务，向 Claude Desktop、Cursor 等 MCP 客户端提供创建邮箱、列出、读取、删除邮件及获取地址等五个工具。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "pexni-smails": {
      "command": "npx",
      "args": [
        "-y",
        "@smails/cli"
      ]
    }
  }
}
启动命令npx -y @smails/cli

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
npm@smails/cli0.0.12

工具

5

收录的工具列表 · 更新于 2 周前

参数类型必填说明
forceboolean否设置为 true 以替换现有邮箱
domainstring否用于邮箱的域名

详细介绍

@smails/cli

npm

供人类和 AI Agent 使用的一次性邮箱。 可在终端中操作的临时收件箱，也可以作为 MCP 服务接入任何 AI Agent，让它自行接收验证码和邮件。无需注册。

→ smails.dev

命令行

npx @smails/cli create        # create a mailbox (token saved to ~/.smails)
npx @smails/cli inbox         # list messages
npx @smails/cli read <id>     # read a message (full id or short prefix)
npx @smails/cli delete <id>   # delete a message
npx @smails/cli whoami        # show the current address
npx @smails/cli create --force  # replace with a fresh mailbox

全局安装即可使用更短的命令：

npm i -g @smails/cli
smails create

MCP 服务（供 AI Agent 使用）

将服务添加到任意 MCP 客户端（例如 Claude Desktop — ~/.claude/mcp.json、Cursor 等）：

{
  "mcpServers": {
    "smails": {
      "command": "npx",
      "args": ["@smails/cli", "mcp"]
    }
  }
}

随后，Agent 便可自行创建邮箱并阅读收到的邮件。工具：

工具描述
create_mailbox创建临时邮箱
list_messages列出当前邮箱中的邮件
read_message根据 ID 阅读邮件
delete_message根据 ID 删除邮件
get_address获取当前邮箱地址

配置

  • 当前邮箱（地址 + 令牌）存储在 ~/.smails 中。
  • SMAILS_API_URL 可覆盖 API 基础 URL（默认值为 https://smails.dev）。

链接

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。