MailboxValidator MCP 服务器

这是一个用于 MailboxValidator API 的简单模型上下文协议 (MCP) 服务器实现。它将返回电子邮件地址的验证结果。

功能

• 全面的电子邮件验证：通过检查语法、DNS、MX 服务器、高风险、抑制列表等，检查电子邮件地址是否可达。

• 一次性电子邮件：检查电子邮件地址是否来自临时/一次性电子邮件提供商。

• 免费电子邮件：检查电子邮件地址是否来自免费电子邮件提供商。

要求

此 MCP 服务器需要 API 密钥。您也可以注册获取免费 API 密钥，每月最多可享受 300 次查询。

此设置还使用 Node.js 和 npm，可从 Node.js 网站下载。

设置

按照以下步骤在 Claude Desktop 中使用此 MCP 服务器：

1. 将存储库下载到本地。

2. 在项目文件夹内运行以下命令以安装依赖项并构建服务器。

npm install
npm run build

3. 确保您已安装 Claude Desktop，如果没有，请从此处下载（适用于 Windows 和 MacOS 用户），或按照此指南操作（适用于 Linux 用户）。

4. 在您选择的编辑器中打开 claude_desktop_config.json，如果您还没有该文件，请按照此指南创建一个。

5. 将以下内容添加到您的 claude_desktop_config.json 中：

{
  "mcpServers": {
    "mailboxvalidator": {
      "command": "node",
      "args": [
        "C:\\path\\to\\mcp-mailboxvalidator\\build\\index.js"
      ],
      "env": {
        "MAILBOXVALIDATOR_API_KEY": "<YOUR_API_KEY>"
      }
    }
  }
}

6. 请记住将 index.js 的路径替换为您本地机器上 MailboxValidator MCP 服务器的实际路径。

7. 要获取您的 API 密钥，只需登录到您的仪表板即可获取。将上述内容中的 <YOUR_API_KEY> 替换为您实际的 API 密钥。

8. 保存更改后重启 Claude Desktop，您应该会在 Search and tools 菜单中看到它。

使用方法

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

• (email) 是有效的电子邮件地址吗？

• (email) 是虚假电子邮件吗？

• (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 字符串。结果包括以下字段：

• Disposable List：检查电子邮件域是否来自临时或一次性电子邮件提供商。

如果请求失败，该工具将返回一个错误消息字符串。

check_free_email

描述 检查给定的电子邮件地址是否来自免费电子邮件提供商。

参数 email (str)：要检查的电子邮件地址。

返回 包含免费电子邮件数据的 JSON 字符串。结果包括以下字段：

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

如果请求失败，该工具将返回一个错误消息字符串。

许可证

请参阅 LICENSE 文件。