MCP 服务器

Apollo.io MCP Server

将 Apollo.io API 功能作为工具公开的 MCP 服务器

edwardchoh

开发者工具

访问服务器

README

Apollo.io MCP 服务器

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

概述

该项目包含以下主要组件：

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

功能

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

people_enrichment: 使用人员信息补全端点来补全 1 个人的数据。
organization_enrichment: 使用组织信息补全端点来补全 1 家公司的数据。
people_search: 使用人员搜索端点来查找人员。
organization_search: 使用组织搜索端点来查找组织。
organization_job_postings: 使用组织职位发布端点来查找特定组织的职位发布。

用法

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

使用您的 Apollo.io API 密钥设置 APOLLO_IO_API_KEY 环境变量。或者在项目根目录中创建包含 APOLLO_IO_API_KEY 的 '.env' 文件。
获取依赖项：uv sync
运行 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 一起使用

通过将这些 MCP 服务器添加到您的 claude_desktop_config.json 文件中，配置 Claude for Desktop 以使用它们：

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