Atdata Email Verification MCP Server

AtData SafeToSend MCP服务器

一种模型上下文协议（MCP）服务器，使用AtData的SafeToSend API提供电子邮件验证服务。此服务器允许您验证电子邮件地址，以过滤掉无效和高风险的电子邮件地址，从而提高打开率、点击率和转化率。

https://docs.atdata.com/reference/safe-to-send

特性

• 邮件验证：使用AtData的SafeToSend API验证单个电子邮件地址
• 批验证：使用摘要统计信息一次验证多个电子邮件地址
• 全面的错误处理：不同故障场景的详细错误消息
• 环境变量支持：通过环境变量实现安全的API密钥管理
• 限速意识：正确处理API速率限制

安装

1. 克隆此存储库：

git clone 
cd atdata-mcp-server

1. 使用uv（推荐）或pip安装依赖项：

# Using uv
uv sync

# Using pip
uv pip install .

设置

获取AtData API密钥

1. 在以下网址注册AtData帐户 https://atdata.com
2. 从AtData仪表板获取API密钥
3. 将API密钥设置为环境变量：

export ATDATA_API_KEY="your-api-key-here"

或者创建一个 .env 项目根目录中的文件：

ATDATA_API_KEY=your-api-key-here

用法

运行服务器

方法1：直接执行Python

python server.py

方法2：使用FastMCP CLI

fastmcp run server.py

方法3：为Claude Desktop安装

fastmcp install server.py

使用紫外线

如果你使用的是uv，你也可以用以下命令运行服务器：

{
  "mcpServers": {
    "atdata-email-verification-mcp-server": {
      "command": "uv",
      "args": ["run", "python", "server.py"],
      "cwd": "/path/to/your/atdata-email-verification-mcp-server",
      "env": {
        "ATDATA_API_KEY": "your_api_key_here"
      }
    }
  }
}

可用工具

1. verify_email

验证单个电子邮件地址。

参数：

• email （string，必填）：要验证的电子邮件地址
• api_key （字符串，可选）：AtData API键（如果未提供，则使用环境变量）

例子：

{
    "email": "user@example.com",
    "api_key": "your-api-key"  # Optional if ATDATA_API_KEY is set
}

答复：

{
    "success": True,
    "email": "user@example.com",
    "verification_result": {
        "email": "user@example.com",
        "status": "valid",
        "deliverable": True,
        "risk_level": "low",
        # Additional verification details from AtData API
    }
}

2. batch_verify_emails

批量验证多个电子邮件地址。

参数：

• emails （字符串数组，必填）：要验证的电子邮件地址列表
• api_key （字符串，可选）：AtData API键（如果未提供，则使用环境变量）

例子：

{
    "emails": ["user1@example.com", "user2@domain.com", "invalid@email"],
    "api_key": "your-api-key"  # Optional if ATDATA_API_KEY is set
}

答复：

{
    "results": [
        {
            "success": True,
            "email": "user1@example.com",
            "verification_result": { /* verification details */ }
        },
        {
            "success": True,
            "email": "user2@domain.com", 
            "verification_result": { /* verification details */ }
        },
        {
            "error": "Bad request. Please check the email format.",
            "email": "invalid@email",
            "status_code": 400
        }
    ],
    "summary": {
        "total": 3,
        "successful": 2,
        "failed": 1,
        "success_rate": 66.67
    }
}

错误处理

服务器为各种场景提供全面的错误处理：

• 缺少API密钥：未提供API密钥时返回错误
• 身份验证错误：处理无效的API密钥（401状态）
• 错误请求：处理无效的电子邮件格式（400状态）
• 速率限制：处理超过API速率限制的情况（429状态）
• 网络问题：处理连接错误和超时
• 意外错误：捕获并报告任何意外异常

API 文档

此服务器基于AtData SafeToSend API。有关底层API的更多详细信息，请参阅：

• AtData SafeToSend API文档

发展

项目结构

atdata-mcp-server/
├── src/
│   └── server.py          # Main MCP server implementation
├── pyproject.toml         # Project configuration and dependencies
├── uv.lock               # Locked dependencies
└── README.md             # This file

贡献

1. 分叉存储库
2. 创建要素分支
3. 进行更改
4. 如果适用，添加测试
5. 提交拉取请求

许可证

该项目根据MIT许可证获得许可。有关详细信息，请参阅LICENSE文件。

支持

关于以下问题：

• 此MCP服务器：在此存储库中打开一个问题
• Atdata API：联系AtData支持或查看他们的文档
• FastMCP框架：检查 FastMCP文档