mcp-mailboxvalidator

MailboxValidator MCP 服务器是 MailboxValidator API 的一个简单 Model Context Protocol（MCP）服务器实现，用于返回电子邮件地址的验证结果。

用途： 该工具主要用于电子邮件验证，帮助用户判断电子邮件地址是否可能可达，从而在营销活动中减少退信。

主要能力：

• 全面电子邮件验证：检查电子邮件地址的语法、DNS、MX 服务器、高风险、抑制列表等，以判断邮件是否可达。
• 一次性邮箱检查：检查电子邮件地址是否来自临时/一次性电子邮件提供商。
• 免费邮箱检查：检查电子邮件地址是否来自免费电子邮件提供商。

使用方式： 该 MCP 服务器需要 API 密钥。用户可以注册免费 API 密钥，每月最多可享受 300 次查询。设置还需要 Node.js 和 npm，可从 Node.js 网站下载。

与 Claude Desktop 配合使用的步骤：

1. 将仓库下载到本地。
2. 在项目文件夹内运行以下命令以安装依赖并构建服务器。
3. 确保已安装 Claude Desktop。如果尚未安装，Windows 和 macOS 用户可从此处下载，Linux 用户可遵循本指南。
4. 打开 claude_desktop_config.json。如果还没有该文件，请遵循本指南创建。
5. 将以下内容添加到 claude_desktop_config.json 中： 注意将 index.js 的路径替换为本地机器上 MailboxValidator MCP 服务器的实际路径。
6. 获取 API 密钥：登录仪表板并从中获取。将上述内容中的 <YOUR_API_KEY> 替换为实际 API 密钥。
7. 保存更改后重启 Claude Desktop，应该会在“搜索和工具”菜单中看到它。

在 Claude Desktop 的聊天中，只需输入关于电子邮件地址的查询。一些示例查询：

• Is (email) a valid email address?
• Is (email) a fake email?
• Is (email) a free email?

在 Claude Desktop 中，模型将根据 MailboxValidator MCP 服务器返回的结果自动生成输出。

环境变量： MAILBOXVALIDATOR_API_KEY

免费 MailboxValidator API 密钥允许每月查询最多 300 封电子邮件。如果需要更多，可以注册付费 API 计划。

工具说明：

validate_email 描述：验证给定的电子邮件地址。它通过检查语法、DNS、MX 服务器、一次性列表等，帮助用户确定电子邮件地址是否可能可达。 参数：email (str)：要验证的电子邮件地址。 返回：包含验证数据的 JSON 字符串。结果包括以下字段：

• Syntax：检查电子邮件地址是否符合电子邮件地址应有的格式。
• DNS & MX Server：检查域名的 DNS 是否指定了 MX 服务器。
• Network & Connectivity：尝试连接 MX 服务器以确保其可运行。
• Greylisting：检查 MX 服务器是否使用灰名单，这可能导致发送到该地址的电子邮件退信。
• Disposable List：检查电子邮件域名是否来自临时或一次性电子邮件提供商。
• High Risk & Suppressed List：检查电子邮件用户名是否看起来高风险，或电子邮件地址是否在抑制列表中。
• Others：检查电子邮件的声誉分数等。 如果请求失败，工具将返回错误消息字符串。

check_disposable_email 描述：检查给定的电子邮件地址是否来自一次性电子邮件提供商。 参数：email (str)：要检查的电子邮件地址。 返回：包含一次性电子邮件数据的 JSON 字符串。结果包括以下字段：

check_free_email 描述：检查给定的电子邮件地址是否来自免费电子邮件提供商。 返回：包含免费电子邮件数据的 JSON 字符串。结果包括以下字段：

• Free Email List：检查电子邮件域名是否来自免费电子邮件提供商。

许可证： 参见 LICENSE 文件。

适用场景： 适用于需要在营销活动中验证电子邮件地址、减少退信率的场景，尤其是与 Claude Desktop 等支持 MCP 的客户端集成时。

限制：

• 需要 API 密钥，免费密钥每月最多 300 次查询。
• 需要 Node.js 和 npm 环境。
• 目前资料主要描述与 Claude Desktop 的集成方式，其他客户端支持情况暂未提供。