TryKitt.ai mcp サーバー
TryKitt.ai APIを使用したメール検証および検索機能を提供するFastMCP(Model Context Protocol)サーバー。このサーバーにより、AIアシスタントはB2Bメールアドレスを高精度かつ低いバウンス率で検出・検証できるようになります。
特徴
メール検証: 高度なSMTPおよびキャッチオール検証でメールアドレスを検証します
メール検索: 個人の名前と会社のドメインを使用して、個人のメールアドレスを検索します
求人管理: メールの検証/求人の検索を追跡および監視します
リアルタイム処理:電子メール操作の即時結果を取得
高精度: TryKitt.ai の高度な検証アルゴリズムを活用し、直帰率は 0.1% 未満
Related MCP server: Graphiti MCP Server
インストール
このリポジトリをクローンします:
git clone https://github.com/avivshafir/trykittai-mcp-server
cd trykittai-mcp-serveruv を使用して新しい 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/Linuxuv を使用して依存関係をインストールします。
# 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を使用する
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 プロフィールの URLcustom_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倍高速に動作します
包括的な検証にエンタープライズ ID サーバーを使用する
ジョブの変更を検出し、実際のシステムに対して検証します
詳細については、https://trykitt.ai/をご覧ください。
ライセンス
このプロジェクトは MIT ライセンスに基づいてライセンスされています - 詳細についてはLICENSEファイルを参照してください。
貢献
リポジトリをフォークする
機能ブランチを作成する
変更を加える
該当する場合はテストを追加する
プルリクエストを送信する
サポート
以下に関連する問題について:
このMCPサーバー: このリポジトリで問題を開く
TryKitt.ai API: TryKitt.ai サポートにお問い合わせください
FastMCPフレームワーク: FastMCPのドキュメントを確認してください
変更履歴
バージョン1.0.0
メール認証と検索機能を備えた初期リリース
ジョブステータスの追跡
リアルタイム処理サポート
FastMCP統合