TryKitt.ai mcp 服务器

一个 FastMCP（模型上下文协议）服务器，使用 TryKitt.ai API 提供电子邮件验证和查找功能。该服务器使 AI 助手能够以高准确性和低退信率找到并验证 B2B 电子邮件地址。

特性

• 电子邮件验证：通过高级 SMTP 和 catchall 验证来验证电子邮件地址
• 电子邮件查找：根据姓名和公司域名查找个人的电子邮件地址
• 任务管理：跟踪和监控电子邮件验证/查找任务
• 实时处理：即时获取电子邮件操作的结果
• 高准确性：利用 TryKitt.ai 的高级验证算法，退信率低于 0.1%

安装

1. 克隆此仓库：
   bash
   git clone https://github.com/avivshafir/trykittai-mcp-server
   cd trykittai-mcp-server

2. 使用 uv 初始化一个新的 Python 环境：
   bash

初始化一个新的 uv 项目（如果从头开始）

uv init

或者创建一个虚拟环境

uv venv

激活虚拟环境

source .venv/bin/activate # 在 macOS/Linux 上

1. 使用 uv 安装依赖项：
   bash

使用 uv（推荐）

uv sync

设置

1. 获取您的 TryKitt.ai API 密钥：

   • 访问 TryKitt.ai
   • 注册一个帐户
   • 导航到您的 API 设置以获取您的 API 密钥

2. 将您的 API 密钥设置为环境变量：
   bash
   export TRYKITT_API_KEY="your_api_key_here"

或者在项目根目录中创建一个 .env 文件：

TRYKITT_API_KEY=your_api_key_here

使用

运行服务器

启动 FastMCP 服务器：
bash
python server.py

服务器将启动并可用于 MCP 连接。

添加到 MCP 客户端

要将此服务器与支持 MCP 的客户端一起使用，您需要配置客户端以连接到此服务器。

Claude Desktop

将以下配置添加到您的 Claude Desktop 配置文件中：

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%Claudeclaude_desktop_config.json

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

如果您正在使用 uv，也可以通过以下方式运行服务器：

json
{
"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（可选）：与请求关联的自定义数据

示例：
python
result = await verify_email_send("john.doe@example.com")

2. 电子邮件查找 (find_email)

根据姓名和公司域名查找一个人的电子邮件地址。

参数：

• full_name（必需）：人的全名
• domain（必需）：公司域名或网站
• linkedin_url（可选）：LinkedIn 个人资料 URL 以提高准确性
• custom_data（可选）：与请求关联的自定义数据

示例：
python
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

示例:
python
result = await get_job_status("job_123456")

4. 列出任务 (list_jobs)

列出所有任务（注意：此端点可能有使用限制）。

示例:
python
result = await list_jobs()

API 响应格式

成功的电子邮件验证

json
{
"id": "job_123456",
"status": "completed",
"result": {
"email": "john.doe@example.com",
"valid": true,
"deliverable": true,
"confidence": 0.95,
"verification_type": "smtp_catchall"
}
}

成功的电子邮件查找

json
{
"id": "job_789012",
"status": "completed",
"result": {
"email": "john.doe@example.com",
"confidence": 0.88,
"sources": ["pattern_matching", "web_scraping"]
}
}

错误处理

服务器处理各种错误场景：

• 无效的API密钥
• 速率限制
• 网络超时
• 无效的电子邮件格式
• 域名验证失败

常见的错误响应：
json
{
"error": "Invalid API key",
"code": 401
}

配置

环境变量

• TRYKITT_API_KEY: 您的TryKitt.ai API密钥（必需）

SSL配置

服务器已配置为与TryKitt.ai的API端点一起工作。目前为了兼容性，SSL验证已被禁用。

开发

项目结构

trykittai-mcp-server/
├── server.py # 主FastMCP服务器实现
├── pyproject.toml # 项目依赖和配置
├── uv.lock # 依赖锁定文件
├── README.md # 本文件
├── LICENSE # MIT许可证
└── .venv/ # 虚拟环境

依赖项

• fastmcp: 用于构建MCP服务器的FastMCP框架
• httpx: 异步HTTP客户端，用于API请求
• pydantic: 数据验证和设置管理

关于TryKitt.ai

TryKitt.ai是一个先进的电子邮件验证和查找服务，它：

• 为个人用户提供无限免费的电子邮件验证
• 通过高级验证实现<0.1%的退回率
• 比替代解决方案快2-5倍
• 使用企业身份服务器进行catchall验证
• 检测职位变动并针对真实系统进行验证

了解更多请访问 https://trykitt.ai/

许可证

该项目根据MIT许可证发布 - 详情请参阅LICENSE文件。

贡献

1. 分叉仓库
2. 创建功能分支
3. 进行更改
4. 如适用，添加测试
5. 提交拉取请求

支持

对于以下问题：

• 该MCP服务器：在此仓库中打开一个issue
• TryKitt.ai API：联系TryKitt.ai支持
• FastMCP框架：查阅FastMCP文档

更新日志

v1.0.0

• 初始版本，具备电子邮件验证和查找功能
• 任务状态跟踪
• 实时处理支持
• FastMCP集成