TryKitt.ai mcp 服务器

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

特性

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

安装

克隆此仓库： bash git clone https://github.com/avivshafir/trykittai-mcp-server cd trykittai-mcp-server
使用 uv 初始化一个新的 Python 环境： bash

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

uv init

或者创建一个虚拟环境

uv venv

激活虚拟环境

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

使用 uv 安装依赖项： bash

使用 uv（推荐）

uv sync

设置

获取您的 TryKitt.ai API 密钥：
- 访问 TryKitt.ai
- 注册一个帐户
- 导航到您的 API 设置以获取您的 API 密钥
将您的 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文件。

贡献

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

支持

对于以下问题：

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

更新日志

v1.0.0

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

服务配置

[{'mcpServers': {'trykittai': {'args': ['/path/to/your/trykittai-mcp-server/server.py'], 'command': 'python', 'env': {'TRYKITT_API_KEY': 'your_api_key_here'}}}}, {'mcpServers': {'trykittai': {'args': ['run', 'python', 'server.py'], 'command': 'uv', 'cwd': '/path/to/your/trykittai-mcp-server', 'env': {'TRYKITT_API_KEY': 'your_api_key_here'}}}}]

来源

来源：github
链接：https://github.com/avivshafir/trykittai-mcp-server

avivshafir