AtData SafeToSend MCP服务器
一种模型上下文协议（MCP）服务器，使用AtData的SafeToSend API提供电子邮件验证服务。此服务器允许您验证电子邮件地址，以过滤掉无效和高风险的电子邮件地址，从而提高打开率、点击率和转化率。
https://docs.atdata.com/reference/safe-to-send
特性
- 邮件验证：使用AtData的SafeToSend API验证单个电子邮件地址
- 批验证：使用摘要统计信息一次验证多个电子邮件地址
- 全面的错误处理：不同故障场景的详细错误消息
- 环境变量支持：通过环境变量实现安全的API密钥管理
- 限速意识：正确处理API速率限制
安装
- 克隆此存储库：
git clone
cd atdata-mcp-server- 使用uv（推荐）或pip安装依赖项：
# Using uv
uv sync
# Using pip
uv pip install .设置
获取AtData API密钥
- 在以下网址注册AtData帐户 https://atdata.com
- 从AtData仪表板获取API密钥
- 将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-mcp-server/
├── src/
│ └── server.py # Main MCP server implementation
├── pyproject.toml # Project configuration and dependencies
├── uv.lock # Locked dependencies
└── README.md # This file贡献
- 分叉存储库
- 创建要素分支
- 进行更改
- 如果适用，添加测试
- 提交拉取请求
许可证
该项目根据MIT许可证获得许可。有关详细信息，请参阅LICENSE文件。
支持
关于以下问题：
- 此MCP服务器：在此存储库中打开一个问题
- Atdata API：联系AtData支持或查看他们的文档
- FastMCP框架：检查 FastMCP文档