isitdisposable-mcp

本地服务

isitdisposable.com安全012 周前更新

代码仓库访问官网

关于 isitdisposable-mcp

isitdisposable-mcp 通过 isitdisposable.com API 供 AI Agent 检查邮箱地址或域名是否为一次性邮箱，并提供单项及批量检查结果和建议处理方式。

主要功能

01检查邮箱地址
02检查域名
03批量检查最多 100 项
04返回判定结果和处理建议
05检查失败时允许通过

适用场景

01筛查注册用邮箱
02注册时评估域名
03批量检查邮箱或域名

MCP 相关

向 MCP 客户端提供邮箱、域名和批量检查工具。需要 isitdisposable.com API 密钥。

配置

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

mcp.json · 通用配置

{
  "mcpServers": {
    "richelo-isitdisposable": {
      "command": "npx",
      "args": [
        "-y",
        "isitdisposable-mcp"
      ],
      "env": {
        "ISITDISPOSABLE_API_KEY": "<ISITDISPOSABLE_API_KEY>"
      }
    }
  }
}

启动命令npx -y isitdisposable-mcp

需要配置的环境变量

ISITDISPOSABLE_API_KEY密钥The secret API key for isitdisposable.com, used to authenticate every check. Get a free key at https://isitdisposable.com.

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

安装包

npmisitdisposable-mcp0.1.1stdio

工具

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

参数	类型	必填	说明
email	string	是	要检查的完整电子邮件地址，例如 [email protected]。

详细介绍

isitdisposable-mcp

一个模型上下文协议（MCP）服务，可让 AI Agent 使用 isitdisposable.com 应用程序编程接口（API）检查电子邮件地址或域名是否为一次性地址。

安装

此服务已发布到 npm registry，通常使用 npx 运行，因此无需手动安装；以下示例展示了如何将其接入模型上下文协议（MCP）宿主。

Claude Desktop

将以下内容添加到 Claude Desktop 配置中：

{
  "mcpServers": {
    "isitdisposable": {
      "command": "npx",
      "args": ["-y", "isitdisposable-mcp"],
      "env": { "ISITDISPOSABLE_API_KEY": "your_secret_key" }
    }
  }
}

Claude Code

claude mcp add isitdisposable --env ISITDISPOSABLE_API_KEY=your_secret_key -- npx -y isitdisposable-mcp

获取 API 密钥

需要 isitdisposable.com 密钥。请在 https://isitdisposable.com 获取免费密钥（提供免费层级），然后在上述配置中将其设为 ISITDISPOSABLE_API_KEY。

工具

工具	功能
`check_email`	检查单个电子邮件地址是否为一次性地址。
`check_domain`	检查单个纯域名（不含本地部分）是否为一次性域名。
`check_batch`	在一次调用中批量检查最多 100 个电子邮件地址或纯域名。可在 `items` 列表中自由混合完整地址和纯域名；包含 `@` 符号的条目会作为电子邮件地址发送，其余条目均作为域名发送。

每个工具都会返回相同格式的判定结果。disposable 是核心的布尔判定：一次性地址是用于接收一条注册消息、规避常规注册要求的临时邮箱，而非真实的长期邮箱。action 是建议采取的处理方式：allow、warn 或 block。结果中还可能包含少量可选信号，包括 mx_valid（该域名的邮件服务器是否接受邮件）、relay（转发或全收型地址）、public_domain（Gmail 等知名免费服务商）以及 did_you_mean（如果给出的域名看起来有拼写错误，可能是用户想输入的域名）。

失败时默认放行

此服务始终采用失败时默认放行的策略。如果网络问题、超时、速率限制或服务器错误导致检查无法完成，工具调用仍会成功（不会抛出异常或导致连接崩溃）。服务会在短暂延迟后重试一次；如果重试仍然失败，就会返回包含 checked: false、disposable: null 和 action: "allow" 的结果，并附上说明检查无法完成的 note。使用此工具的 Agent 应将此结果视为无法得出结论，而不是将其视为地址安全的信号。

如果未配置 API 密钥，服务仍会正常启动并响应模型上下文协议（MCP）握手；此后每次工具调用都会返回错误结果，提示前往 https://isitdisposable.com 获取免费密钥。

支持 Markdown

登录后评论