TryKitt.ai mcp 服务器
一个 FastMCP（模型上下文协议）服务器，使用TryKitt.ai API 提供电子邮件验证和查找功能。该服务器使 AI 助手能够以高精度和低退回率查找和验证 B2B 电子邮件地址。
特征
电子邮件验证：使用高级 SMTP 和 catchall 验证来验证电子邮件地址
电子邮件查找：使用姓名和公司域名查找个人的电子邮件地址
工作管理：跟踪和监控电子邮件验证/寻找工作
实时处理：立即获得电子邮件操作的结果
高精度：利用 TryKitt.ai 的先进验证算法，跳出率低于 0.1%
Related MCP server: Graphiti MCP Server
安装
克隆此存储库：
git clone https://github.com/avivshafir/trykittai-mcp-server
cd trykittai-mcp-server使用 uv 初始化一个新的 Python 环境：
# Initialize a new uv project (if starting fresh)
uv init
# Or create a virtual environment
uv venv
# Activate the virtual environment
source .venv/bin/activate # On macOS/Linux使用 uv 安装依赖项：
# Using uv (recommended)
uv sync设置
获取您的 TryKitt.ai API 密钥：
注册账户
导航到您的 API 设置以获取您的 API 密钥
将您的 API 密钥设置为环境变量：
export TRYKITT_API_KEY="your_api_key_here"或者在项目根目录中创建一个.env文件：
TRYKITT_API_KEY=your_api_key_here用法
运行服务器
启动 FastMCP 服务器：
python server.py服务器将启动并可用于 MCP 连接。
添加至 MCP 客户端
要将此服务器与 MCP 兼容客户端一起使用，您需要配置客户端以连接到此服务器。
克劳德桌面
将以下配置添加到您的 Claude Desktop 配置文件：
macOS ： ~/Library/Application Support/Claude/claude_desktop_config.json Windows ： %APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"trykittai": {
"command": "python",
"args": ["/path/to/your/trykittai-mcp-server/server.py"],
"env": {
"TRYKITT_API_KEY": "your_api_key_here"
}
}
}
}其他 MCP 客户端
对于其他与 MCP 兼容的客户端，请将其配置为连接到：
命令：
python参数：
["/path/to/your/trykittai-mcp-server/server.py"]环境变量：
TRYKITT_API_KEY=your_api_key_here
与紫外线一起使用
如果您使用 uv，您还可以使用以下命令运行服务器：
{
"mcpServers": {
"trykittai": {
"command": "uv",
"args": ["run", "python", "server.py"],
"cwd": "/path/to/your/trykittai-mcp-server",
"env": {
"TRYKITT_API_KEY": "your_api_key_here"
}
}
}
}注意：将/path/to/your/trykittai-mcp-server替换为您的项目目录的实际绝对路径，并将your_api_key_here为您的实际 TryKitt.ai API 密钥。
可用工具
1. 电子邮件验证（ verify_email_send ）
验证电子邮件地址是否有效且可传送。
参数：
email（必填）：需要验证的电子邮件地址custom_data（可选）：与请求关联的自定义数据
例子：
result = await verify_email_send("john.doe@example.com")2. 电子邮件查找（ find_email ）
根据某人的姓名和公司域名查找其电子邮件地址。
参数：
full_name（必填）：此人的全名domain（必填）：公司域名或网站linkedin_url（可选）：LinkedIn 个人资料 URL，以提高准确性custom_data（可选）：与请求关联的自定义数据
例子：
result = await find_email(
full_name="John Doe",
domain="example.com",
linkedin_url="https://linkedin.com/in/johndoe"
)3. 作业状态（ get_job_status ）
检查先前提交的作业的状态。
参数：
job_id（必需）：要检查的作业的 ID
例子：
result = await get_job_status("job_123456")4.列出作业（ list_jobs ）
列出所有作业（注意：此端点的可用性可能有限）。
例子：
result = await list_jobs()API 响应格式
电子邮件验证成功
{
"id": "job_123456",
"status": "completed",
"result": {
"email": "john.doe@example.com",
"valid": true,
"deliverable": true,
"confidence": 0.95,
"verification_type": "smtp_catchall"
}
}成功查找电子邮件
{
"id": "job_789012",
"status": "completed",
"result": {
"email": "john.doe@example.com",
"confidence": 0.88,
"sources": ["pattern_matching", "web_scraping"]
}
}错误处理
服务器处理各种错误情况：
无效的 API 密钥
速率限制
网络超时
电子邮件格式无效
域名验证失败
常见错误响应：
{
"error": "Invalid API key",
"code": 401
}配置
环境变量
TRYKITT_API_KEY：您的 TryKitt.ai API 密钥（必需）
SSL 配置
该服务器已配置为与 TryKitt.ai 的 API 端点配合使用。SSL 验证目前已禁用，以实现兼容性。
发展
项目结构
trykittai-mcp-server/
├── server.py # Main FastMCP server implementation
├── pyproject.toml # Project dependencies and configuration
├── uv.lock # Dependency lock file
├── README.md # This file
├── LICENSE # MIT License
└── .venv/ # Virtual environment依赖项
fastmcp：用于构建 MCP 服务器的 FastMCP 框架httpx：用于 API 请求的异步 HTTP 客户端pydantic：数据验证和设置管理
关于TryKitt.ai
TryKitt.ai 是一种先进的电子邮件验证和查找服务，它：
为个人用户提供无限制的免费电子邮件验证
通过高级验证实现<0.1％的跳出率
比其他解决方案快 2-5 倍
使用企业身份服务器进行全面验证
检测作业变化并针对真实系统进行验证
了解更多信息，请访问 https://trykitt.ai/
执照
该项目根据 MIT 许可证获得许可 - 有关详细信息，请参阅LICENSE文件。
贡献
分叉存储库
创建功能分支
进行更改
如果适用，添加测试
提交拉取请求
支持
对于相关问题：
此 MCP 服务器：在此存储库中打开一个问题
TryKitt.ai API：联系 TryKitt.ai 支持
FastMCP 框架：查看 FastMCP 文档
变更日志
v1.0.0
首次发布具有电子邮件验证和查找功能
工作状态跟踪
实时处理支持
FastMCP 集成