Trykitt MCP Server

Trykitt MCP Server

このプロジェクトは、B2B メールアドレスを優れた精度と速度で検索・検証するために設計された強力なプラットフォーム、Trykitt API（https://trykitt.ai/）をラップする Model Context Protocol（MCP）サーバーを実装しています。

Trykitt の高度な機能を、AI ワークフローで直接活用できます。多くのプロバイダーを上回る数の B2B メールアドレスを、ほぼゼロのバウンス率で見つけられます。また、単純な SMTP チェックにとどまらず、企業の ID サーバーを使って検証し、従来の方法と比べて大幅に速い結果を得られます。キャッチオールを検証し、転職を検出して、アウトリーチ活動を強化しましょう。

---

英語

概要

この MCP サーバーを使うと、言語モデル（Claude、ChatGPT、Gemini など）が Trykitt API（https://trykitt.ai/）とやり取りできます。AI アシスタントは、Trykitt の最先端のメール検索・検証エンジンを利用できます。このエンジンは、多くの代替サービスよりも多くの有効な B2B メールアドレスを、より速く、より高い信頼性で提供するよう設計されています（Trykitt が報告するバウンス率は 0.1％未満です）。キャッチオールを検証し、転職を検出して、アウトリーチ活動を強化しましょう。

機能

• 以下の Trykitt API エンドポイントをラップする MCP ツールを提供します。
  • GET /job?id={job_id}（ツール：get_job）
  • POST /job/find_email（ツール：find_email）
  • POST /job/verify_email（ツール：verify_email）
• API キー認証を処理します。
• find_email と verify_email のジョブでリアルタイム処理を強制します。

前提条件

• Node.js（v18 以降を推奨）
• npm（通常は Node.js に付属しています）
• Trykitt API キー

セットアップ

1. リポジトリをクローンします：

   git clone <repository_url> # Replace with the actual URL
   cd trykitt-mcp
   

2. 依存関係をインストールします：

   npm install
   

3. API キーを設定します： プロジェクトのルートに .env ファイルを作成します。

   TRYKITT_API_KEY=YOUR_TRYKITT_API_KEY
   

   YOUR_TRYKITT_API_KEY を実際の Trykitt API キーに置き換えます。

サーバーの起動

npm start

これにより MCP サーバーが起動し、MCP クライアント（Claude Desktop、Cursor など）からの接続を stdio で待ち受けます。サーバーはステータスを stderr に記録します。

利用可能なツール

• get_job：以前に送信した Trykitt ジョブのステータスまたは結果を取得します。
  • パラメーター：job_id（文字列、必須）
  • 最小限の JSON の例：

    {
      "tool_name": "get_job",
      "parameters": {
        "job_id": "01JEXAMPLEJOBID"
      }
    }
    

• find_email：人物のメールアドレスを検索します。
  • パラメーター：fullName（文字列、必須）、domainOrWebsite（文字列、必須）、companyName（文字列、任意）、linkedinStandardProfileURL（文字列、任意）、callbackType（文字列、任意）、callbackURL（文字列、任意）、fastMode（ブール値、任意）、customData（文字列、任意）、discoverAlternativeDomains（ブール値、任意）、dataProviderFallback（ブール値、任意）
  • 最小限の JSON の例：

    {
      "tool_name": "find_email",
      "parameters": {
        "fullName": "Erol Toker",
        "domainOrWebsite": "trykitt.ai"
      }
    }
    

  • 完全な JSON の例：

    {
      "tool_name": "find_email",
      "parameters": {
        "fullName": "Jane Doe",
        "domainOrWebsite": "https://example.com/",
        "companyName": "Example Corp",
        "linkedinStandardProfileURL": "https://linkedin.com/in/janedoe-example",
        "callbackType": "here",
        "callbackURL": "",
        "fastMode": false,
        "customData": "project_alpha_lead_42",
        "discoverAlternativeDomains": true,
        "dataProviderFallback": true
      }
    }
    

• verify_email：メールアドレスが有効かどうかを検証します。
  • パラメーター：email（文字列、必須）、treatAliasesAsValid（ブール値、任意、デフォルト：true）
  • 最小限の JSON の例：

    {
      "tool_name": "verify_email",
      "parameters": {
        "email": "[email protected]"
      }
    }
    

  • 完全な JSON の例：

    {
      "tool_name": "verify_email",
      "parameters": {
        "email": "[email protected]",
        "treatAliasesAsValid": false
      }
    }
    

クライアント設定の例（例：Claude Desktop の settings.json）

このサーバーを MCP クライアントで使用するには、サーバーコマンドを実行するようにクライアントを設定する必要があります。設定例を以下に示します。

{
  "mcpServers": {
    "trykitt": {
      "command": "node",
      "args": ["/path/to/your/trykitt-mcp/src/index.js"], // IMPORTANT: Replace with the actual absolute path
      "env": {
        "TRYKITT_API_KEY": "YOUR_TRYKITT_API_KEY" // IMPORTANT: Replace with your actual key
      }
    }
  }
}

重要：

• /path/to/your/trykitt-mcp/src/index.js を、クローンしたプロジェクトディレクトリ内にある index.js ファイルの正しい絶対パスに置き換えてください。
• YOUR_TRYKITT_API_KEY を実際の Trykitt API キーに置き換えてください。trykitt-mcp プロジェクトディレクトリ内の .env ファイルにキーを設定している場合は、ここで env ブロックを省略することもできます。サーバーはそのファイルからキーを読み込みます。

---

フランス語

概要

この MCP（Model Context Protocol）サーバーは、並外れた精度と速度で B2B メールアドレスを検索・検証するために設計された強力なプラットフォーム、Trykitt API（https://trykitt.ai/）をラップする機能を実装しています。

Trykitt の高度な機能を、AI ワークフローで直接活用できます。多くのプロバイダーより多くの B2B メールアドレスをほぼゼロのバウンス率で見つけ、単純な SMTP 検証にとどまらず企業の ID サーバーに照会して検証し、従来の方法と比べて大幅に速い結果を得られます。

機能

この MCP サーバーを使うと、言語モデル（Claude、ChatGPT、Gemini など）が Trykitt API（https://trykitt.ai/）とやり取りできます。アシスタントが、Trykitt の高度な検索・メール検証エンジンを利用できるようになります。このエンジンは、多くの代替サービスよりも多くの有効な B2B メールアドレスを、より迅速かつ高い信頼性で提供できるよう設計されています（Trykitt の報告によると、バウンス率は <0,1%）。「catchall」アドレスの検証、転職の検出、見込み客開拓の取り組みの改善に役立ちます。

特徴

• Trykitt API の次のエンドポイントをラップする MCP ツールを提供します：
  • GET /job?id={job_id} （ツール：get_job）
  • POST /job/find_email （ツール：find_email）
  • POST /job/verify_email （ツール：verify_email）
• API キー認証を処理します。
• find_email および verify_email ジョブをリアルタイムで処理するよう強制します。

前提条件

• Node.js（v18 以降を推奨）
• npm（通常は Node.js に含まれています）
• Trykitt API キー

インストール

1. リポジトリをクローンします：

   git clone <repository_url> # 実際の URL に置き換えてください
   cd trykitt-mcp
   

2. 依存関係をインストールします：

   npm install
   

3. API キーを設定します： プロジェクトのルートに .env ファイルを作成します：

   TRYKITT_API_KEY=VOTRE_CLE_API_TRYKITT
   

   VOTRE_CLE_API_TRYKITT を実際の Trykitt API キーに置き換えてください。

サーバーの起動

npm start

これにより MCP サーバーが起動し、MCP クライアント（Claude Desktop、Cursor など）からの接続を stdio で待ち受けます。サーバーのステータスは stderr に表示されます。

利用可能なツール

• get_job: 以前に送信した Trykitt ジョブのステータスまたは結果を取得します。
  • パラメーター: job_id（文字列、必須）
  • 最小 JSON の例：

    {
      "tool_name": "get_job",
      "parameters": {
        "job_id": "01JEXAMPLEJOBID"
      }
    }
    

• find_email: 人物のメールアドレスを検索します。
  • パラメーター: fullName（文字列、必須）、domainOrWebsite（文字列、必須）、companyName（文字列、任意）、linkedinStandardProfileURL（文字列、任意）、callbackType（文字列、任意）、callbackURL（文字列、任意）、fastMode（ブール値、任意）、customData（文字列、任意）、discoverAlternativeDomains（ブール値、任意）、dataProviderFallback（ブール値、任意）
  • 最小 JSON の例：

    {
      "tool_name": "find_email",
      "parameters": {
        "fullName": "Erol Toker",
        "domainOrWebsite": "trykitt.ai"
      }
    }
    

  • 完全な JSON の例：

    {
      "tool_name": "find_email",
      "parameters": {
        "fullName": "Jeanne Dupont",
        "domainOrWebsite": "https://exemple.fr/",
        "companyName": "Exemple SA",
        "linkedinStandardProfileURL": "https://linkedin.com/in/jeannedupont-exemple",
        "callbackType": "here",
        "callbackURL": "",
        "fastMode": false,
        "customData": "projet_alpha_piste_42",
        "discoverAlternativeDomains": true,
        "dataProviderFallback": true
      }
    }
    

• verify_email: メールアドレスが有効かどうかを確認します。
  • パラメーター: email（文字列、必須）、treatAliasesAsValid（ブール値、任意、デフォルト: true）
  • 最小 JSON の例：

    {
      "tool_name": "verify_email",
      "parameters": {
        "email": "[email protected]"
      }
    }
    

  • 完全な JSON の例：

    {
      "tool_name": "verify_email",
      "parameters": {
        "email": "[email protected]",
        "treatAliasesAsValid": false
      }
    }
    

クライアント設定の例（例：Claude Desktop の settings.json）

このサーバーを MCP クライアントで使用するには、サーバーのコマンドを実行するようにクライアントを設定する必要があります。設定例を以下に示します。

{
  "mcpServers": {
    "trykitt": {
      "command": "node",
      "args": ["/chemin/vers/votre/trykitt-mcp/src/index.js"], // IMPORTANT : Remplacez par le chemin absolu réel
      "env": {
        "TRYKITT_API_KEY": "VOTRE_CLE_API_TRYKITT" // IMPORTANT : Remplacez par votre clé réelle
      }
    }
  }
}

重要：

• /chemin/vers/votre/trykitt-mcp/src/index.js を、クローンしたプロジェクトのディレクトリにある index.js ファイルの正しい絶対パスに置き換えてください。
• VOTRE_CLE_API_TRYKITT を実際の Trykitt API キーに置き換えてください。また、プロジェクトのルートにある trykitt-mcp 自体の .env ファイルでキーを設定している場合は、ここで env ブロックを省略することもできます。サーバーはそこからキーを取得します。