trykittai-mcp-server

TryKitt.ai mcp サーバー

TryKitt.ai APIを使用したメール検証および検索機能を提供するFastMCP（Model Context Protocol）サーバー。このサーバーにより、AIアシスタントはB2Bメールアドレスを高精度かつ低いバウンス率で検出・検証できるようになります。

特徴

メール検証: 高度なSMTPおよびキャッチオール検証でメールアドレスを検証します
メール検索: 個人の名前と会社のドメインを使用して、個人のメールアドレスを検索します
求人管理: メールの検証/求人の検索を追跡および監視します
リアルタイム処理:電子メール操作の即時結果を取得
高精度: 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を使用する

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倍高速に動作します
包括的な検証にエンタープライズ ID サーバーを使用する
ジョブの変更を検出し、実際のシステムに対して検証します

詳細については、https://trykitt.ai/をご覧ください。

ライセンス

このプロジェクトは MIT ライセンスに基づいてライセンスされています - 詳細についてはLICENSEファイルを参照してください。

貢献

リポジトリをフォークする
機能ブランチを作成する
変更を加える
該当する場合はテストを追加する
プルリクエストを送信する

サポート

以下に関連する問題について:

このMCPサーバー: このリポジトリで問題を開く
TryKitt.ai API: TryKitt.ai サポートにお問い合わせください
FastMCPフレームワーク: FastMCPのドキュメントを確認してください

変更履歴

バージョン1.0.0

メール認証と検索機能を備えた初期リリース
ジョブステータスの追跡
リアルタイム処理サポート
FastMCP統合

trykittai-mcp-server

TryKitt.ai mcp サーバー

特徴

インストール

設定

使用法

サーバーの実行

MCPクライアントへの追加

クロードデスクトップ

その他のMCPクライアント

UVを使用する

利用可能なツール

1. メール認証（ `verify_email_send` ）

2. メール検索（ `find_email` ）

3. ジョブステータス（ `get_job_status` ）

4. ジョブの一覧表示（ `list_jobs` ）

APIレスポンスフォーマット

メール認証成功

メールの発見に成功

エラー処理

構成

環境変数

SSL設定

発達

プロジェクト構造

依存関係

TryKitt.aiについて

ライセンス

貢献

サポート

変更履歴

バージョン1.0.0

Related MCP Servers

salesforce-mcp

MISP-MCP-SERVER

KiCAD-MCP-Server

mcp-server-docy

New MCP Servers

MCP directory API

TryKitt.ai mcp サーバー

特徴

インストール

設定

使用法

サーバーの実行

MCPクライアントへの追加

クロードデスクトップ

その他のMCPクライアント

UVを使用する

利用可能なツール

1. メール認証（ verify_email_send ）

2. メール検索（ find_email ）

3. ジョブステータス（ get_job_status ）

4. ジョブの一覧表示（ list_jobs ）

APIレスポンスフォーマット

メール認証成功

メールの発見に成功

エラー処理

構成

環境変数

SSL設定

発達

プロジェクト構造

依存関係

TryKitt.aiについて

ライセンス

貢献

サポート

変更履歴

バージョン1.0.0

Related MCP Servers

salesforce-mcp

MISP-MCP-SERVER

KiCAD-MCP-Server

mcp-server-docy

New MCP Servers

MCP directory API

1. メール認証（ `verify_email_send` ）

2. メール検索（ `find_email` ）

3. ジョブステータス（ `get_job_status` ）

4. ジョブの一覧表示（ `list_jobs` ）