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 機能を簡単に追加できます

インストール

# 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アクセストークンが必要です。以下の方法で取得できます。

Apollo.ioアカウントにアクセスする
設定 > API へ移動
APIキーの生成

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

環境変数として:
APOLLO_IO_API_KEY=your-api-key
コマンドライン引数として:
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パッケージを使用します。認証を実装するには、以下の手順に従います。

パッケージをインストールします。
npm install mcp-proxy-auth
AUTH_SERVER_URL環境変数を、API キー検証エンドポイントを指すように設定します。
export AUTH_SERVER_URL=https://your-auth-server.com/verify
認証付きで SSE サーバーを実行します。
npx mcp-proxy-auth node dist/index.js
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 人の人物のデータをエンリッチします。
- パラメータ:
  - first_name (文字列、オプション): 人の名
  - last_name (文字列、オプション): 人の姓
  - email (文字列、オプション): 個人のメールアドレス
  - domain （文字列、オプション）: 会社のドメイン
  - organization_name (文字列、オプション): 組織名
- 例：
  { "first_name": "John", "last_name": "Doe", "email": "john.doe@example.com" }
組織の強化
- 組織エンリッチメントエンドポイントを使用して、1 社のデータをエンリッチメントします。
- パラメータ:
  - domain （文字列、オプション）: 会社のドメイン
  - name (文字列、オプション): 会社名
- 例：
  { "domain": "apollo.io" }
人探し
- 人を検索するには、人検索エンドポイントを使用します。
- パラメータ:
  - q_organization_domains_list (配列、オプション): 検索対象となる組織ドメインのリスト
  - person_titles (配列、オプション): 検索する役職のリスト
  - person_seniorities (配列、オプション): 検索する役職レベルのリスト
- 例：
  { "person_titles": ["Marketing Manager"], "person_seniorities": ["vp"], "q_organization_domains_list": ["apollo.io"] }
組織検索
- 組織検索エンドポイントを使用して組織を検索する
- パラメータ:
  - q_organization_domains_list (配列、オプション): 検索する組織ドメインのリスト
  - organization_locations (配列、オプション): 検索する組織の場所のリスト
- 例：
  { "organization_locations": ["Japan", "Ireland"] }
組織の求人情報
- 組織の求人情報エンドポイントを使用して、特定の組織の求人情報を検索します。
- パラメータ:
  - organization_id (文字列、必須): Apollo.io 組織 ID
- 例：
  { "organization_id": "5e60b6381c85b4008c83" }

サーバーの拡張

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

src/apollo-client.tsのApolloClientクラスに新しいメソッドを追加します。
src/index.tsのsetupToolHandlersメソッドに新しいツールを登録します。
npm run buildでプロジェクトをリビルドします。

ライセンス

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

キーワード

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

Apollo.io MCP Server

Integrations