Apollo.io API MCP服务

Apollo.io MCP 服务器

该项目提供了一个MCP服务器，该服务器将Apollo.io API功能作为工具公开。它允许您使用模型上下文协议（MCP）与Apollo.io API进行交互。

概述

该项目由以下主要部分组成：

• apollo_client.py：定义 ApolloClient 类，用于与Apollo.io API交互。它包括人员充实、组织充实、人员搜索、组织搜索和组织职位发布的方法。
• server.py：定义FastMCP服务器，该服务器将Apollo.io API功能作为工具公开。它使用 ApolloClient 类定义于 apollo_client.py 以与API交互。
• apollo/：包含Apollo.io API的数据模型，例如 PeopleEnrichmentQuery, OrganizationEnrichmentQuery, PeopleSearchQuery, OrganizationSearchQuery，以及 OrganizationJobPostingsQuery.

功能

以下功能作为MCP工具公开：

• people_enrichment：使用People Enrichment端点来丰富1个人的数据。
• organization_enrichment：使用Organization Enrichment端点来丰富1家公司的数据。
• people_search：使用人员搜索端点查找人员。
• organization_search：使用“组织搜索”端点查找组织。
• organization_job_postings：使用“组织职位发布”端点查找特定组织的职位发布。

用法

要使用此MCP服务器，您需要：

1. 设置 APOLLO_IO_API_KEY Apollo.io API密钥的环境变量。或者在项目根目录中创建“.env”文件 APOLLO_IO_API_KEY.
2. 获取依赖关系： uv sync
3. 跑吧 uv run mcp run server.py

数据模型

这 apollo/ 目录包含Apollo.io API的数据模型。这些模型用于定义MCP工具的输入和输出。

• apollo/people.py：定义人员扩展端点的数据模型。
• apollo/organization.py：定义组织扩展端点的数据模型。
• apollo/people_search.py：定义人员搜索端点的数据模型。
• apollo/organization_search.py：定义组织搜索端点的数据模型。
• apollo/organization_job_postings.py：定义组织职位发布端点的数据模型。

测试

要测试，请设置 APOLLO_IO_API_KEY 环境变量和运行 uv run apollo_client.py.

使用Claude for Desktop

1. 将Claude for Desktop配置为使用这些MCP服务器，方法是将它们添加到您的 claude_desktop_config.json 文件：

{
  "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协议文件
• Claude桌面文档