Apollo.io MCP 服务器

强大的模型上下文协议 (MCP) 服务器实现，可实现无缝的 Apollo.io API 集成，使 AI 助手能够与 Apollo.io 数据进行交互。

概述

该 MCP 服务器提供了一套与 Apollo.io API 交互的全面工具，允许 AI 助手：

• 丰富个人和组织的数据
• 搜索人员和组织
• 查找特定组织的招聘信息
• 无需离开 AI 助手界面即可执行 Apollo.io 操作

为什么要使用此 MCP 服务器？

• 无缝 AI 集成：将您的 AI 助手直接连接到 Apollo.io 数据
• 简化的 API 操作：通过自然语言命令执行常见的 Apollo.io 任务
• 实时数据访问：从 Apollo.io 获取最新信息
• 安全认证：使用 Apollo.io 的安全 API 令牌认证
• 可扩展设计：根据需要轻松添加更多 Apollo.io API 功能

安装

配置

服务器需要 Apollo.io API 访问令牌。您可以通过以下方式获取：

1. 前往你的Apollo.io 账户
2. 导航至“设置”>“API”
3. 生成 API 密钥

您可以通过两种方式提供令牌：

1. 作为环境变量：
   APOLLO_IO_API_KEY=your-api-key
2. 作为命令行参数：
   npm start -- --api-key=your-api-key

为了开发，请在项目根目录中创建一个.env文件来存储环境变量：

用法

启动服务器

在 SSE 服务器中实现身份验证

SSE 服务器使用mcp-proxy-auth软件包进行身份验证。要实现身份验证，请执行以下操作：

1. 安装软件包：
   npm install mcp-proxy-auth
2. 设置AUTH_SERVER_URL环境变量以指向您的 API 密钥验证端点：
   export AUTH_SERVER_URL=https://your-auth-server.com/verify
3. 使用身份验证运行 SSE 服务器：
   npx mcp-proxy-auth node dist/index.js
4. SSE URL 可在以下位置获取：
   localhost:8080/sse?apiKey=apikey
   将apikey替换为您实际的用于身份验证的 API 密钥。

mcp-proxy-auth包充当代理：

• 拦截对 SSE 服务器的请求
• 根据您的身份验证服务器验证 API 密钥
• 仅允许经过身份验证的请求到达您的 SSE 端点

与人工智能助手集成

此 MCP 服务器旨在与支持模型上下文协议 (MCP) 的 AI 助手配合使用。运行后，服务器会公开一组工具，供兼容的 AI 助手使用，与 Apollo.io 数据进行交互。

可用工具

该服务器公开了以下强大的 Apollo.io 集成工具：

1. 人员充实
   • 使用人员扩充端点来扩充 1 个人的数据
   • 参数：
     • first_name （字符串，可选）：人的名字
     • last_name （字符串，可选）：人的姓氏
     • email （字符串，可选）：个人的电子邮件地址
     • domain （字符串，可选）：公司域
     • organization_name （字符串，可选）：组织名称
   • 例子：
     { "first_name": "John", "last_name": "Doe", "email": "john.doe@example.com" }
2. 组织丰富
   • 使用组织丰富端点丰富 1 家公司的数据
   • 参数：
     • domain （字符串，可选）：公司域
     • name （字符串，可选）：公司名称
   • 例子：
     { "domain": "apollo.io" }
3. people_search
   • 使用人员搜索端点来查找人员
   • 参数：
     • q_organization_domains_list （数组，可选）：要搜索的组织域列表
     • person_titles （数组，可选）：要搜索的职位列表
     • person_seniorities （数组，可选）：要搜索的资历级别列表
   • 例子：
     { "person_titles": ["Marketing Manager"], "person_seniorities": ["vp"], "q_organization_domains_list": ["apollo.io"] }
4. 组织搜索
   • 使用组织搜索端点查找组织
   • 参数：
     • q_organization_domains_list （数组，可选）：要搜索的组织域列表
     • organization_locations （数组，可选）：要搜索的组织位置列表
   • 例子：
     { "organization_locations": ["Japan", "Ireland"] }
5. 组织职位发布
   • 使用“组织职位发布”端点查找特定组织的职位发布
   • 参数：
     • organization_id （字符串，必需）：Apollo.io 组织 ID
   • 例子：
     { "organization_id": "5e60b6381c85b4008c83" }

扩展服务器

该服务器设计为易于扩展。要添加新的 Apollo.io API 功能，请执行以下操作：

1. 在src/apollo-client.ts中向ApolloClient类添加新方法
2. 在src/index.ts中的setupToolHandlers方法中注册新工具
3. 使用npm run build重建项目

执照

该项目根据 MIT 许可证获得许可 - 有关详细信息，请参阅 LICENSE 文件。

关键词

Apollo.io、模型上下文协议、MCP、AI 助手、TypeScript、API 集成、Apollo.io API、人员丰富、组织丰富、人员搜索、组织搜索、职位发布、AI 工具