TryKitt.ai mcp服务器
FastMCP（模型上下文协议）服务器，使用 TryKitt.ai API该服务器使AI助手能够以高精度和低跳出率查找和验证B2B电子邮件地址。
特性
- 电子邮件验证：使用高级SMTP和全面验证验证电子邮件地址
- 电子邮件查找：查找使用个人姓名和公司域的个人电子邮件地址
- 作业管理：跟踪和监控电子邮件验证/找工作
- 实时处理：立即获得电子邮件操作的结果
- 高精度：利用TryKitt.ai的高级验证算法，跳出率\<0.1%
安装
- 克隆此存储库：
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密钥：
- 访问 TryKitt.ai - 注册一个账户 - 导航到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 视窗: %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许可证获得许可-请参阅 许可证 文件以获取详细信息。
贡献
- 分叉存储库
- 创建要素分支
- 进行更改
- 如果适用，添加测试
- 提交拉取请求
支持
关于以下问题：
- 此MCP服务器：在此存储库中打开问题
- TryKitt.ai API：联系TryKitt.ai支持
- FastMCP框架：查看FastMCP文档
更新日志
v1.0.0
- 具有电子邮件验证和查找功能的初始版本
- 作业状态跟踪
- 实时处理支持
- FastMCP集成