Mailboxvalidator

MailboxValidator MCP 服务

这是一个简单的 MailboxValidator API 模型上下文协议（MCP）服务实现。它会返回电子邮件地址的验证结果。

功能

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

要求

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

本地 MCP 服务设置还需要 Node.js 和 npm，可从 Node.js 网站下载。

设置

有两种方式可以使用此 MCP 服务：

• 云托管 MCP 服务：直接连接到托管的 MailboxValidator MCP 服务。无需在本地安装任何内容。
• 本地 MCP 服务：下载并在自己的机器上运行此服务。

选项 1：云托管 MCP 服务

如果你想直接连接到托管服务，请使用此选项。

方法 A：直接通过 HTTP 连接

如果你的 MCP 客户端支持通过 HTTP 连接远程服务，请使用此方法。无需使用 Node.js、npm 或 npx。

{
  "mcpServers": {
    "mailboxvalidator": {
      "type": "http",
      "url": "https://mcp.mailboxvalidator.com/mcp",
      "headers": {
        "X-API-Key": "<YOUR_API_KEY>"
      }
    }
  }
}

如果你的客户端通过命令行配置，例如 Claude Code，可以通过以下方式添加服务：

claude mcp add --transport http mailboxvalidator https://mcp.mailboxvalidator.com/mcp --header "X-API-Key: <YOUR_API_KEY>"

方法 B：通过 npx 连接

如果你的 MCP 客户端仅支持本地（stdio）服务，请使用此方法。mcp-remote 包会在本地运行，并将请求转发到托管服务。此方法需要 Node.js。

{
  "mcpServers": {
    "mailboxvalidator": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote@latest",
        "https://mcp.mailboxvalidator.com/mcp",
        "--header",
        "X-API-Key:<YOUR_API_KEY>"
      ]
    }
  }
}

要获取 API 密钥，只需登录控制面板并从中获取，然后将上面示例中的 <YOUR_API_KEY> 替换为你的实际 API 密钥。

保存更改后，重启 Claude Desktop，你应该会在 Search and tools 菜单中看到该服务。

选项 2：本地 MCP 服务

按照以下步骤在自己的机器上运行 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 字符串。结果包括以下字段：

• 语法：检查电子邮件地址是否符合标准格式。
• DNS 和 MX 服务器：检查域名 DNS 是否指定了 MX 服务器。
• 网络和连接：尝试连接 MX 服务器，以确保其正常运行。
• 灰名单：检查 MX 服务器是否使用可能导致发送到该地址的邮件被退回的灰名单机制。
• 一次性邮箱列表：检查电子邮件域名是否来自临时或一次性邮箱提供商。
• 高风险和抑制列表：检查电子邮件用户名是否看起来有较高风险，或电子邮件地址是否出现在抑制列表中。
• 其他：检查电子邮件的信誉评分等。

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

check_disposable_email

描述 检查给定的电子邮件地址是否来自一次性邮箱提供商。

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

返回值 包含一次性邮箱数据的 JSON 字符串。结果包括以下字段：

• 一次性邮箱列表：检查电子邮件域名是否来自临时或一次性邮箱提供商。

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

check_free_email

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

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

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

• 免费邮箱列表：检查电子邮件域名是否来自免费邮箱提供商。

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

许可证

请参阅 LICENSE 文件。