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服务器,您需要:
- 设置
APOLLO_IO_API_KEYApollo.io API密钥的环境变量。或者在项目根目录中创建“.env”文件APOLLO_IO_API_KEY. - 获取依赖关系:
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
- 将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"
]
}
}
}