Skip to main content
Glama
trykittai-mcp-server

trykittai-mcp-server

by avivshafir

TryKitt.ai mcp 服务器

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

特征

  • 电子邮件验证:使用高级 SMTP 和 catchall 验证来验证电子邮件地址

  • 电子邮件查找:使用姓名和公司域名查找个人的电子邮件地址

  • 工作管理:跟踪和监控电子邮件验证/寻找工作

  • 实时处理:立即获得电子邮件操作的结果

  • 高精度:利用 TryKitt.ai 的先进验证算法,跳出率低于 0.1%

Related MCP server: ones-wiki-mcp-server

安装

  1. 克隆此存储库:

git clone https://github.com/avivshafir/trykittai-mcp-server
cd trykittai-mcp-server
  1. 使用 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
  1. 使用 uv 安装依赖项:

# Using uv (recommended)
uv sync

设置

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

    • 访问TryKitt.ai

    • 注册账户

    • 导航到您的 API 设置以获取您的 API 密钥

  2. 将您的 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文件。

贡献

  1. 分叉存储库

  2. 创建功能分支

  3. 进行更改

  4. 如果适用,添加测试

  5. 提交拉取请求

支持

对于相关问题:

  • 此 MCP 服务器:在此存储库中打开一个问题

  • TryKitt.ai API:联系 TryKitt.ai 支持

  • FastMCP 框架:查看 FastMCP 文档

变更日志

v1.0.0

  • 首次发布具有电子邮件验证和查找功能

  • 工作状态跟踪

  • 实时处理支持

  • FastMCP 集成

Available Tools

4 tools
find_emailC
Find an email address for a person.

Args:
    full_name: The full name of the person
    domain: The company domain or website
    linkedin_url: Optional LinkedIn profile URL
    custom_data: Optional custom data to associate with the request

Inputs: full_name (required), domain (required), linkedin_url, custom_data.

get_job_statusB
Get the status of a job.

Args:
    job_id: The ID of the job to check

Inputs: job_id (required).

list_jobsD

List jobs

Inputs: no named parameters.

verify_email_sendC
verify an email using trykitt.

Args:
    email: The email address to verify
    custom_data: Optional custom data to associate with the request

Inputs: email (required), custom_data.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    C2.9/5.0

    Scored across 4 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose with no overlap: find_email locates email addresses, get_job_status checks job status, list_jobs enumerates jobs, and verify_email_send validates emails. The descriptions clearly differentiate their functions, eliminating any potential for agent misselection.

    Naming Consistency4/5

    The naming follows a consistent verb_noun pattern (find_email, get_job_status, list_jobs, verify_email_send), with all tools using snake_case. The minor deviation is 'verify_email_send' which includes an extra verb 'send', but overall the pattern is predictable and readable.

    Tool Count5/5

    With 4 tools, this server is well-scoped for its purpose of email and job management. Each tool earns its place by covering distinct aspects: email discovery, job tracking, and email verification, without being overly sparse or bloated.

    Completeness3/5

    The tool surface covers core operations like finding and verifying emails, and managing jobs, but has notable gaps. For example, there are no tools to create or delete jobs, or to handle email sending beyond verification, which could limit agent workflows in this domain.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    Appeared in Searches