Apollo.io MCP サーバー

シームレスな Apollo.io API 統合を実現する強力な Model Context Protocol (MCP) サーバー実装により、AI アシスタントが Apollo.io データと対話できるようになります。

概要

この MCP サーバーは、Apollo.io API と対話するための包括的なツール セットを提供し、AI アシスタントが次のことを実行できるようにします。

• 個人と組織のためのデータを充実させる

• 人物や組織を検索する

• 特定の組織の求人情報を探す

• AIアシスタントインターフェースを離れずにApollo.ioの操作を実行

この MCP サーバーを使用する理由

• シームレスなAI統合：AIアシスタントをApollo.ioデータに直接接続

• 簡素化された API 操作: 自然言語コマンドを通じて一般的な Apollo.io タスクを実行します。

• リアルタイムデータアクセス：Apollo.ioから最新情報を入手

• 安全な認証: Apollo.ioの安全なAPIトークン認証を使用します

• 拡張可能な設計: 必要に応じて Apollo.io API 機能を簡単に追加できます

インストール

構成

サーバーにはApollo.io APIアクセストークンが必要です。以下の方法で取得できます。

1. Apollo.ioアカウントにアクセスする

2. 設定 > API へ移動

3. APIキーの生成

トークンは次の 2 つの方法で提供できます。

1. 環境変数として:

   APOLLO_IO_API_KEY=your-api-key

2. コマンドライン引数として:

   npm start -- --api-key=your-api-key

開発の場合は、プロジェクト ルートに.envファイルを作成して環境変数を保存します。

使用法

サーバーの起動

SSEサーバーでの認証の実装

SSEサーバーは認証にmcp-proxy-authパッケージを使用します。認証を実装するには、以下の手順に従います。

1. パッケージをインストールします。

   npm install mcp-proxy-auth

2. AUTH_SERVER_URL環境変数を、API キー検証エンドポイントを指すように設定します。

   export AUTH_SERVER_URL=https://your-auth-server.com/verify

3. 認証付きで SSE サーバーを実行します。

   npx mcp-proxy-auth node dist/index.js

4. SSE URL は次の場所で入手できます。

   localhost:8080/sse?apiKey=apikey

   認証用の実際の API キーにapikey置き換えます。

mcp-proxy-authパッケージは、次の機能を果たすプロキシとして機能します。

• SSEサーバーへのリクエストをインターセプトします

• 認証サーバーに対してAPIキーを検証します

• 認証されたリクエストのみが SSE エンドポイントに到達できるようにします

AIアシスタントとの統合

このMCPサーバーは、モデルコンテキストプロトコル（MCP）をサポートするAIアシスタントと連携するように設計されています。サーバーが起動すると、互換性のあるAIアシスタントがApollo.ioのデータとやり取りするために使用できるツールセットが公開されます。

利用可能なツール

サーバーは、次の強力な Apollo.io 統合ツールを公開します。

1. 人々の豊かさ

   • 人物エンリッチメントエンドポイントを使用して、1 人の人物のデータをエンリッチします。

   • パラメータ:

     • first_name (文字列、オプション): 人の名

     • last_name (文字列、オプション): 人の姓

     • email (文字列、オプション): 個人のメールアドレス

     • domain （文字列、オプション）: 会社のドメイン

     • organization_name (文字列、オプション): 組織名

   • 例：

     { "first_name": "John", "last_name": "Doe", "email": "john.doe@example.com" }

2. 組織の強化

   • 組織エンリッチメントエンドポイントを使用して、1 社のデータをエンリッチメントします。

   • パラメータ:

     • domain （文字列、オプション）: 会社のドメイン

     • name (文字列、オプション): 会社名

   • 例：

     { "domain": "apollo.io" }

3. 人探し

   • 人を検索するには、人検索エンドポイントを使用します。

   • パラメータ:

     • q_organization_domains_list (配列、オプション): 検索対象となる組織ドメインのリスト

     • person_titles (配列、オプション): 検索する役職のリスト

     • person_seniorities (配列、オプション): 検索する役職レベルのリスト

   • 例：

     { "person_titles": ["Marketing Manager"], "person_seniorities": ["vp"], "q_organization_domains_list": ["apollo.io"] }

4. 組織検索

   • 組織検索エンドポイントを使用して組織を検索する

   • パラメータ:

     • q_organization_domains_list (配列、オプション): 検索する組織ドメインのリスト

     • organization_locations (配列、オプション): 検索する組織の場所のリスト

   • 例：

     { "organization_locations": ["Japan", "Ireland"] }

5. 組織の求人情報

   • 組織の求人情報エンドポイントを使用して、特定の組織の求人情報を検索します。

   • パラメータ:

     • organization_id (文字列、必須): Apollo.io 組織 ID

   • 例：

     { "organization_id": "5e60b6381c85b4008c83" }

サーバーの拡張

サーバーは簡単に拡張できるように設計されています。Apollo.io APIの新しい機能を追加するには、以下の手順に従ってください。

1. src/apollo-client.tsのApolloClientクラスに新しいメソッドを追加します。

2. src/index.tsのsetupToolHandlersメソッドに新しいツールを登録します。

3. npm run buildでプロジェクトをリビルドします。

ライセンス

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

キーワード

Apollo.io、モデルコンテキストプロトコル、MCP、AIアシスタント、TypeScript、API統合、Apollo.io API、人材エンリッチメント、組織エンリッチメント、人材検索、組織検索、求人情報、AIツール