trykittai-mcp-服务器

TryKitt.ai mcp 服务器

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

特征

电子邮件验证：使用高级 SMTP 和 catchall 验证来验证电子邮件地址
电子邮件查找：使用姓名和公司域名查找个人的电子邮件地址
工作管理：跟踪和监控电子邮件验证/寻找工作
实时处理：立即获得电子邮件操作的结果
高精度：利用 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 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 集成

trykittai-mcp-server