使用说明
truelist mcp
MCP（模型上下文协议）服务器 真实列表 电子邮件验证。让Claude、Cursor和VS Code Copilot等人工智能助手验证电子邮件地址的可送达性。
这是什么？
此软件包公开了Truelist的电子邮件验证API作为MCP工具。配置后，您的AI助手可以：
- 检查电子邮件地址是否有效且可交付
- 一次性验证多批电子邮件
- 检查您的Truelist帐户信息和计划
免费开始 --100次验证+10个增强积分，无需信用卡。 获取API密钥→ 使用免费计划。
安装
npm install -g truelist-mcp
或者直接与 npx:
npx truelist-mcp
配置
您需要一个Truelist API密钥。得到一个在 truelist.io.
克劳德桌面版
添加到您的 claude_desktop_config.json:
macOS： ~/Library/Application Support/Claude/claude_desktop_config.json
窗户： %APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"truelist": {
"command": "npx",
"args": ["truelist-mcp"],
"env": {
"TRUELIST_API_KEY": "your-api-key"
}
}
}
}
克劳德代码
添加到您的 .claude/settings.json 或运行：
claude mcp add truelist -- npx truelist-mcp
然后设置环境变量：
export TRUELIST_API_KEY=your-api-key
光标
添加到光标MCP设置(.cursor/mcp.json 在项目或全局设置中）：
{
"mcpServers": {
"truelist": {
"command": "npx",
"args": ["truelist-mcp"],
"env": {
"TRUELIST_API_KEY": "your-api-key"
}
}
}
}
VS代码（GitHub副本）
添加到您的VS代码设置(.vscode/mcp.json 在您的项目中）：
{
"servers": {
"truelist": {
"command": "npx",
"args": ["truelist-mcp"],
"env": {
"TRUELIST_API_KEY": "your-api-key"
}
}
}
}
工具
validate_email
验证单个电子邮件地址的可送达性。
输入：
{
"email": "user@example.com"
}
输出：
{
"email": "user@example.com",
"state": "ok",
"sub_state": "email_ok",
"suggestion": null,
"domain": "example.com",
"canonical": "user@example.com",
"mx_record": "mx.example.com",
"first_name": "Jane",
"last_name": "Doe",
"verified_at": "2026-02-21T12:00:00Z",
"is_valid": true,
"is_deliverable": true
}
国家：
| 状态 | 含义 |
|---|---|
ok |
电子邮件可交付 |
email_invalid |
电子邮件无法送达 |
risky |
电子邮件可能是可交付的，但有风险因素 |
accept_all |
域接受所有地址；交付能力不确定 |
unknown |
无法确定可送达性 |
子状态：
| 子状态 | 含义 |
|---|---|
email_ok |
未发现问题 |
accept_all |
域接受所有地址 |
is_disposable |
临时/一次性电子邮件 |
is_role |
基于角色的地址（info@、support@等） |
failed_mx_check |
域没有邮件服务器 |
failed_smtp_check |
SMTP验证失败 |
failed_spam_trap |
已知垃圾邮件陷阱地址 |
failed_no_mailbox |
邮箱不存在 |
failed_greylisted |
服务器暂时被拒绝 |
failed_syntax_check |
电子邮件语法无效 |
unknown |
无法确定子状态 |
validate_email
一次性验证多个电子邮件地址（最多50个）。
输入：
{
"emails": [
"user@example.com",
"test@invalid.example",
"hello@gmail.com"
]
}
输出：
[
{
"email": "user@example.com",
"state": "ok",
"sub_state": "email_ok",
"is_valid": true
},
{
"email": "test@invalid.example",
"state": "email_invalid",
"sub_state": "failed_mx_check",
"is_valid": false
},
{
"email": "hello@gmail.com",
"state": "ok",
"sub_state": "email_ok",
"is_valid": true
}
]
check_计数
检查您的Truelist帐户信息，包括姓名、电子邮件、计划和管理员状态。
输入： 无
输出：
{
"email": "you@company.com",
"name": "Your Name",
"uuid": "a3828d19-...",
"timeZone": "America/New_York",
"isAdminRole": true,
"paymentPlan": "pro"
}
环境变量
| 变量 | 必填 | 描述 |
|---|---|---|
TRUELIST_API_KEY |
是 | 您的Truelist API密钥来自 truelist.io |
故障排除
“TRUELIST_API_KEY环境变量是必需的”
服务器需要 TRUELIST_API_KEY 环境变量。确保已在MCP配置中设置 env 阻止或导出到您的shell中。
工具未显示在Claude/Cursor中
- 更改MCP配置后重新启动AI助手
- 检查一下
npx truelist-mcp运行时没有错误TRUELIST_API_KEY已设置 - 验证配置文件路径是否适用于您的平台
身份验证错误
在验证您的API密钥是否正确且处于活动状态 truelist.io.
速率限制
Truelist对API强制执行速率限制。如果达到速率限制，SDK将自动重试，并采用指数回退。对于批量验证，电子邮件会同时进行验证，因此大批量可能会触发速率限制。
入门指南
注册一个 免费Truelist帐户 获取您的API密钥。免费计划包括100个验证和10个增强积分，无需信用卡。
许可证
麻省理工学院
