使用说明

项目简介

Apollo.io MCP Server 是一个基于 Model Context Protocol (MCP) 构建的服务器，旨在将 Apollo.io 强大的 B2B 销售情报 API 集成到支持 MCP 协议的 AI 助手和应用中。通过此服务器，AI 助手可以安全、便捷地访问和利用 Apollo.io 的数据资源，实现诸如人员和组织信息查询、数据丰富、职位发布检索等功能，从而提升 AI 应用在销售、营销和招聘等领域的智能化水平。

主要功能点

数据丰富: 提供人员和组织的数据丰富工具，通过姓名、邮箱、域名等信息，获取更全面的画像数据。
信息查询: 支持人员和组织的搜索功能，可以根据职位、行业、地域等条件检索目标客户和合作伙伴。
职位发布: 允许查询特定组织的职位发布信息，帮助 AI 助手了解企业招聘动态。
API集成: 深度集成 Apollo.io API，将复杂的 API 操作封装成易于 AI 助手调用的工具。
标准化协议: 基于 MCP 协议开发，确保与所有兼容 MCP 协议的客户端无缝对接。
灵活配置: 支持环境变量和命令行参数配置 Apollo.io API 密钥。
安全认证: 可选配置 SSE 服务器认证，保障数据访问安全。
可扩展性: 易于扩展，方便开发者根据需求添加更多 Apollo.io API 功能。

安装步骤

克隆仓库

git clone https://github.com/lkm1developer/apollo-io-mcp-server.git
cd apollo-io-mcp-server

安装依赖
```
npm install
```
构建项目
```
npm run build
```

服务器配置

MCP 客户端需要配置以下 JSON 信息以连接到 Apollo.io MCP Server。请根据您的实际情况修改 'command' 和 'args' 字段。

{
  "serverName": "apollo-io-mcp-server",
  "command": "node",
  "args": [
    "dist/index.js"
  ],
  "description": "Apollo.io MCP Server 集成了 Apollo.io API，提供人员和组织数据查询、信息丰富等工具。",
  "capabilities": {
    "tools": [
      "people_enrichment",
      "organization_enrichment",
      "people_search",
      "organization_search",
      "organization_job_postings",
      "get_person_email",
      "employees_of_company"
    ]
  },
  "configuration": {
    "APOLLO_IO_API_KEY": "YOUR_APOLLO_IO_API_KEY"
  },
  "notes": "请将 YOUR_APOLLO_IO_API_KEY 替换为您的 Apollo.io API 密钥。您也可以通过环境变量 APOLLO_IO_API_KEY 或命令行参数 --api-key=YOUR_APOLLO_IO_API_KEY 来配置 API 密钥。"
}

配置参数说明:

'serverName': 服务器名称，可以自定义。
'command': 运行服务器的命令，这里使用 'node'。
'args': 命令参数，指定服务器入口文件 'dist/index.js'。
'description': 服务器描述信息，用于在客户端展示。
'capabilities.tools': 服务器提供的工具列表，客户端可以根据此列表了解服务器的功能。
'configuration.APOLLO_IO_API_KEY': 占位符，并非实际配置项。这里仅为提示 MCP 客户端可能需要配置 API 密钥，实际配置方式请参考 'notes' 中的说明。MCP 服务器的 API 密钥配置通常通过环境变量或命令行参数进行，无需 MCP 客户端直接配置。
'notes': 配置说明，提示用户如何配置 Apollo.io API 密钥。

重要提示:

API 密钥获取: 您需要在 Apollo.io 官网申请并获取 API 密钥。
API 密钥配置方式: 推荐使用环境变量 'APOLLO_IO_API_KEY' 或命令行参数 '--api-key=YOUR_APOLLO_IO_API_KEY' 的方式将 API 密钥传递给服务器。例如，使用命令行启动服务器： 'npm start -- --api-key=YOUR_APOLLO_IO_API_KEY'。
SSE 服务器认证: 如果需要启用 SSE 服务器认证，请参考仓库 README 文档中关于 'mcp-proxy-auth' 的说明进行配置。

基本使用方法

启动服务器: 在项目根目录下运行 'npm start' 命令启动 MCP 服务器。
连接客户端: 在您的 MCP 客户端中，根据上述“服务器配置”部分的信息配置并连接到 Apollo.io MCP Server。
调用工具: 客户端连接成功后，即可通过 MCP 协议调用服务器提供的工具，例如 'people_enrichment'、'organization_search' 等，并传入相应的参数，以获取 Apollo.io 的数据。
查看结果: 服务器会将 Apollo.io API 返回的数据封装成 MCP 响应，客户端解析响应即可获取工具执行结果。

关键词