🚀 Apollo.io MCP 服务器
本项目打造了一个 MCP 服务器，将 Apollo.io API 的各项功能以工具形式对外公开。借助模型上下文协议（MCP），用户能够轻松与 Apollo.io API 展开交互。
🚀 快速开始
要使用此 MCP 服务器，您需要完成以下步骤：
- 将
APOLLO_IO_API_KEY环境变量设置为您的 Apollo.io API 密钥。或者在项目根目录中创建.env文件，并添加APOLLO_IO_API_KEY。 - 获取依赖项：
uv sync - 运行命令：
uv run mcp run server.py
✨ 主要特性
组件构成
该项目主要由以下核心组件构成：
apollo_client.py：定义了用于与 Apollo.io API 交互的ApolloClient类。它涵盖了人物丰富资料、组织丰富资料、人物搜索、组织搜索和组织职位发布等实用方法。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：使用组织职位发布端点查找特定组织的职位发布。
📚 详细文档
数据模型
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 配合使用
- 配置 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"
]
}
}
}