Apollo.io MCP Server

Apollo.io MCP サーバー

このプロジェクトは、Apollo.io API の機能をツールとして公開する MCP サーバーを提供します。Model Context Protocol（MCP）を使用して、Apollo.io API とやり取りできます。

概要

このプロジェクトは、次の主要コンポーネントで構成されています。

• apollo_client.py：Apollo.io API とのやり取りに使用する ApolloClient クラスを定義します。人物情報のエンリッチメント、組織情報のエンリッチメント、人物検索、組織検索、組織の求人情報に関するメソッドが含まれています。
• server.py：Apollo.io API の機能をツールとして公開する FastMCP サーバーを定義します。API とのやり取りには、apollo_client.py で定義された ApolloClient クラスを使用します。
• apollo/：PeopleEnrichmentQuery、OrganizationEnrichmentQuery、PeopleSearchQuery、OrganizationSearchQuery、OrganizationJobPostingsQuery など、Apollo.io API のデータモデルが含まれています。

機能

次の機能が MCP ツールとして公開されています。

• people_enrichment：People Enrichment エンドポイントを使用して、1 人分のデータをエンリッチします。
• organization_enrichment：Organization Enrichment エンドポイントを使用して、1 社分のデータをエンリッチします。
• people_search：People Search エンドポイントを使用して、人物を検索します。
• organization_search：Organization Search エンドポイントを使用して、組織を検索します。
• organization_job_postings：Organization Job Postings エンドポイントを使用して、特定の組織の求人情報を検索します。

使用方法

この MCP サーバーを使用するには、次の手順が必要です。

1. APOLLO_IO_API_KEY 環境変数に Apollo.io API キーを設定します。または、プロジェクトのルートに APOLLO_IO_API_KEY を記載した .env ファイルを作成します。
2. 依存関係を取得します：uv sync
3. uv run mcp run server.py を実行します。

データモデル

apollo/ ディレクトリには、Apollo.io API のデータモデルが含まれています。これらのモデルは、MCP ツールの入力と出力を定義するために使用されます。

• apollo/people.py：People Enrichment エンドポイントのデータモデルを定義します。
• apollo/organization.py：Organization Enrichment エンドポイントのデータモデルを定義します。
• apollo/people_search.py：People Search エンドポイントのデータモデルを定義します。
• apollo/organization_search.py：Organization Search エンドポイントのデータモデルを定義します。
• apollo/organization_job_postings.py：Organization Job Postings エンドポイントのデータモデルを定義します。

テスト

テストするには、APOLLO_IO_API_KEY 環境変数を設定して、uv run apollo_client.py を実行します。

Claude for Desktop での使用方法

1. claude_desktop_config.json ファイルに追加して、これらの MCP サーバーを使用するよう Claude for Desktop を設定します。

{
  "mcpServers": {
    "apollo-io-mcp-server": {
      "type": "stdio",
      "command": "uv",
      "args": [
        "run",
        "mcp",
        "run",
        "path/to/apollo-io-mcp-server/server.py"
      ]
    }
  }
}

リソース

• Apollo.io API ドキュメント
• MCP Protocol ドキュメント
• Claude for Desktop ドキュメント