Hatch MCP Server

Hatch MCP サーバー

これは、Hatch API と連携するための Model Context Protocol（MCP）サーバーです。メールアドレスや電話番号の検索、メールアドレスの検証、企業データの検索、LinkedIn URL の取得に使用できるツールを提供します。

機能

• 名、姓、ドメイン情報を使ってメールアドレスを検索します
• LinkedIn プロフィール URL を使って電話番号を検索します
• メールアドレスが有効で、使用中かどうかを検証します
• ドメインを使って企業の詳細情報を検索します
• 氏名、役職、会社情報を使って LinkedIn URL を検索します

インストール

1. リポジトリをクローンします
2. 依存関係をインストールします。

npm install

3. .env.example を基に .env ファイルを作成し、Hatch API キーを追加します。

HATCH_API_KEY=your_api_key_here

4. プロジェクトをビルドします。

npm run build

使用方法

単体での使用

サーバーを直接起動するには、次のコマンドを実行します。

npm start

Claude との連携

この MCP サーバーを Claude で使用するには、MCP 設定ファイルに追加する必要があります。

1. Claude VSCode 拡張機能の場合は、c:\Users\<username>\AppData\Roaming\Code\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json に追加します
2. Claude デスクトップアプリの場合は、Windows 上の %APPDATA%\Claude\claude_desktop_config.json に追加します

設定例：

{
  "mcpServers": {
    "hatch": {
      "command": "node",
      "args": ["E:/mcp-servers/hatch/dist/index.js"],
      "env": {
        "HATCH_API_KEY": "your_api_key_here"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

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

設定

サーバーは環境変数を使って設定できます。

• HATCH_API_KEY（必須）：Hatch API キー
• HATCH_API_URL（任意）：カスタム API URL（既定値は https://api.hatchhq.ai）
• HATCH_RETRY_MAX_ATTEMPTS：API 呼び出しの最大再試行回数（既定値：3）
• HATCH_RETRY_INITIAL_DELAY：再試行までの初期待機時間（ミリ秒、既定値：1000）
• HATCH_RETRY_MAX_DELAY：再試行までの最大待機時間（ミリ秒、既定値：10000）
• HATCH_RETRY_BACKOFF_FACTOR：再試行の待機時間に適用するバックオフ係数（既定値：2）

利用可能なツール

hatch_find_email

名、姓、ドメイン情報を使ってメールアドレスを検索します。

パラメーター：

• firstName（必須）：人物の名
• lastName（必須）：人物の姓
• domain（必須）：会社のドメイン名

hatch_find_phone

LinkedIn プロフィール URL を使って電話番号を検索します。

パラメーター：

• linkedInUrl（必須）：人物の LinkedIn プロフィール URL

hatch_verify_email

メールアドレスが有効で、使用中かどうかを検証します。

パラメーター：

• email（必須）：検証するメールアドレス

hatch_find_company_data

ドメインを使って企業の詳細情報を検索します。

パラメーター：

• domain（必須）：会社のドメイン名

hatch_get_linkedin_url

氏名、役職、会社情報を使って LinkedIn URL を検索します。

パラメーター：

• name：人物の氏名
• designation：人物の役職
• companyName（必須）：会社名

ライセンス

MIT