Apollo.io MCP Server

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ツール