이 프로젝트는 도구로 Apollo.io API 기능을 노출하는 MCP 서버를 제공합니다. Model Context Protocol (MCP)을 사용하여 Apollo.io API와 상호 작용할 수 있습니다.

개요

프로젝트는 다음과 같은 주요 구성 요소로 구성됩니다.

• apollo_client.py: Apollo.io API와 상호 작용하는 데 사용되는 ApolloClient 클래스를 정의합니다. 해당 이용 후기에 달린 코멘트가 없습니다.
• server.py: 도구로 Apollo.io API 기능을 노출하는 FastMCP 서버를 묶습니다. 그것은 ApolloClient] 클래스 정의 apollo_client.py API와 상호 작용.
• apollo/: PeopleEnrichmentQuery], PeopleSearchQuery], OrganizationSearchQuery, OrganizationJobPostingsQuery와 같은 Apollo.io API의 데이터 모델을 포함합니다.

기능

다음과 같은 기능들은 MCP 도구로 노출됩니다.

• people_enrichment: People Enrichment endpoint를 사용하여 1 인당 데이터를 풍부하게합니다.
• [T12]]: 조직 Enrichment endpoint를 사용하여 1 회사에 대한 데이터를 풍부하게합니다.

Apollo.io MCP Server

This project provides an MCP server that exposes the Apollo.io API functionalities as tools. It allows you to interact with the Apollo.io API using the Model Context Protocol (MCP).

Overview

The project consists of the following main components:

• apollo_client.py: Defines the ApolloClient class, which is used to interact with the Apollo.io API. It includes methods for people enrichment, organization enrichment, people search, organization search, and organization job postings.
• server.py: Defines the FastMCP server, which exposes the Apollo.io API functionalities as tools. It uses the ApolloClient class defined in apollo_client.py to interact with the API.
• apollo/: Contains the data models for the Apollo.io API, such as PeopleEnrichmentQuery, OrganizationEnrichmentQuery, PeopleSearchQuery, OrganizationSearchQuery, and OrganizationJobPostingsQuery.

Functionalities

The following functionalities are exposed as MCP tools:

• people_enrichment: Use the People Enrichment endpoint to enrich data for 1 person.
• organization_enrichment: Use the Organization Enrichment endpoint to enrich data for 1 company.
• people_search: Use the People Search endpoint to find people.
• organization_search: Use the Organization Search endpoint to find organizations.
• organization_job_postings: Use the Organization Job Postings endpoint to find job postings for a specific organization.

Usage

To use this MCP server, you need to:

1. Set the APOLLO_IO_API_KEY environment variable with your Apollo.io API key. Or create ‘.env’ file in the project root with APOLLO_IO_API_KEY.
2. Get dependencies: uv sync
3. Run the uv run mcp run server.py

Data Models

The apollo/ directory contains the data models for the Apollo.io API. These models are used to define the input and output of the MCP tools.

• apollo/people.py: Defines the data models for the People Enrichment endpoint.
• apollo/organization.py: Defines the data models for the Organization Enrichment endpoint.
• apollo/people_search.py: Defines the data models for the People Search endpoint.
• apollo/organization_search.py: Defines the data models for the Organization Search endpoint.
• apollo/organization_job_postings.py: Defines the data models for the Organization Job Postings endpoint.

Testing

To test, set APOLLO_IO_API_KEY environment variable and run uv run apollo_client.py.

Usage with Claude for Desktop

1. Configure Claude for Desktop to use these MCP servers by adding them to your claude_desktop_config.json file:

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

Resources

• Apollo.io API Documentation