Apollo.io MCP Server

Apollo.io MCP サーバー

Apollo.io API とシームレスに連携し、AI アシスタントが Apollo.io のデータを操作できるようにする、強力な Model Context Protocol（MCP）サーバー実装です。

概要

この MCP サーバーは、Apollo.io API を操作するための包括的なツール群を提供し、AI アシスタントで次のことができます。

• 人物や組織のデータを補完する
• 人物や組織を検索する
• 特定の組織の求人情報を検索する
• AI アシスタントのインターフェースを離れずに Apollo.io の操作を実行する

この MCP サーバーを使う理由

• シームレスな AI 連携：AI アシスタントを Apollo.io のデータに直接接続します
• API 操作の簡素化：自然言語のコマンドで一般的な Apollo.io のタスクを実行します
• リアルタイムのデータアクセス：Apollo.io から最新の情報を取得します
• 安全な認証：Apollo.io の安全な API トークン認証を使用します
• 拡張しやすい設計：必要に応じて Apollo.io API の機能を簡単に追加できます

インストール

# Clone the repository
git clone https://github.com/lkm1developer/apollo-io-mcp-server.git
cd apollo-io-mcp-server

# Install dependencies
npm install

# Build the project
npm run build

設定

サーバーには Apollo.io API アクセストークンが必要です。トークンは次の手順で取得できます。

1. Apollo.io アカウントにアクセスします
2. Settings > API に移動します
3. API キーを生成します

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

1. 環境変数として指定する：

   APOLLO_IO_API_KEY=your-api-key
   

2. コマンドライン引数として指定する：

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

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

APOLLO_IO_API_KEY=your-api-key

使い方

サーバーの起動

# Start the server
npm start

# Or with a specific API key
npm start -- --api-key=your-api-key

# Run the SSE server with authentication
npx mcp-proxy-auth node dist/index.js

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
   

   認証には、apikey を実際の API キーに置き換えてください。

mcp-proxy-auth パッケージはプロキシとして動作し、次の処理を行います。

• SSE サーバーへのリクエストを傍受する
• 認証サーバーに対して API キーを検証する
• 認証済みのリクエストのみが SSE エンドポイントに到達できるようにする

AI アシスタントとの連携

この MCP サーバーは、Model Context Protocol をサポートする AI アシスタントと連携するよう設計されています。起動すると、互換性のある AI アシスタントが Apollo.io のデータを操作するために使用できるツール群を公開します。

利用可能なツール

サーバーでは、以下の強力な Apollo.io 統合ツールを利用できます。

1. people_enrichment

   • People Enrichment エンドポイントを使用して、1 人分のデータを拡充します
   • パラメーター：
     • first_name (string, optional)：人物の名
     • last_name (string, optional)：人物の姓
     • email (string, optional)：人物のメールアドレス
     • domain (string, optional)：会社のドメイン
     • organization_name (string, optional)：組織名
   • 例：

     {
       "first_name": "John",
       "last_name": "Doe",
       "email": "[email protected]"
     }
     

2. organization_enrichment

   • Organization Enrichment エンドポイントを使用して、1 社分のデータを拡充します
   • パラメーター：
     • domain (string, optional)：会社のドメイン
     • name (string, optional)：会社名
   • 例：

     {
       "domain": "apollo.io"
     }
     

3. people_search

   • People Search エンドポイントを使用して人物を検索します
   • パラメーター：
     • q_organization_domains_list (array, optional)：検索対象とする組織ドメインのリスト
     • person_titles (array, optional)：検索する役職のリスト
     • person_seniorities (array, optional)：検索する職位レベルのリスト
   • 例：

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

4. organization_search

   • Organization Search エンドポイントを使用して組織を検索します
   • パラメーター：
     • q_organization_domains_list (array, optional)：検索する組織ドメインのリスト
     • organization_locations (array, optional)：検索する組織の所在地のリスト
   • 例：

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

5. organization_job_postings

   • Organization Job Postings エンドポイントを使用して、特定の組織の求人情報を検索します
   • パラメーター：
     • organization_id (string, required)：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 の下でライセンスされています。詳細は LICENSE ファイルをご覧ください。

キーワード

Apollo.io、Model Context Protocol、MCP、AI アシスタント、TypeScript、API 統合、Apollo.io API、人物データの拡充、組織データの拡充、人物検索、組織検索、求人情報、AI ツール