AtData SafeToSend MCP Server

AtData SafeToSend MCP 服务

一个使用 AtData 的 SafeToSend API 提供电子邮件验证服务的模型上下文协议（MCP）服务。此服务可验证电子邮件地址，筛除无效和高风险地址，从而提高打开率、点击率和转化率。

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

功能

• 电子邮件验证：使用 AtData 的 SafeToSend API 验证单个电子邮件地址
• 批量验证：一次验证多个电子邮件地址，并提供汇总统计信息
• 全面的错误处理：针对不同故障场景提供详细的错误消息
• 环境变量支持：通过环境变量安全管理 API 密钥
• 速率限制处理：妥善处理 API 速率限制

安装

1. 克隆此仓库：

git clone <repository-url>
cd atdata-mcp-server

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

# Using uv
uv sync

# Using pip
uv pip install .

设置

获取 AtData API 密钥

1. 在 https://atdata.com 注册 AtData 账户
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

如果使用 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（字符串，必需）：要验证的电子邮件地址
• api_key（字符串，可选）：AtData API 密钥（若未提供，则使用环境变量）

示例：

{
    "email": "[email protected]",
    "api_key": "your-api-key"  # Optional if ATDATA_API_KEY is set
}

响应：

{
    "success": True,
    "email": "[email protected]",
    "verification_result": {
        "email": "[email protected]",
        "status": "valid",
        "deliverable": True,
        "risk_level": "low",
        # Additional verification details from AtData API
    }
}

2. batch_verify_emails

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

参数：

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

示例：

{
    "emails": ["[email protected]", "[email protected]", "invalid@email"],
    "api_key": "your-api-key"  # Optional if ATDATA_API_KEY is set
}

响应：

{
    "results": [
        {
            "success": True,
            "email": "[email protected]",
            "verification_result": { /* verification details */ }
        },
        {
            "success": True,
            "email": "[email protected]", 
            "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. Fork 此仓库
2. 创建功能分支
3. 进行更改
4. 如适用，添加测试
5. 提交拉取请求

许可证

此项目采用 MIT 许可证。详情请参阅 LICENSE 文件。

支持

有关以下问题：

• 此 MCP 服务：在此仓库中提交 issue
• AtData API：联系 AtData 支持团队或查看其文档
• FastMCP 框架：查看 FastMCP 文档