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 文件。