Apollo.io MCP Server

Apollo.io MCP 服务

强大的 Model Context Protocol（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 功能

安装

# Clone the repository
git clone https://github.com/lkm1developer/apollo-io-mcp-server.git
cd apollo-io-mcp-server

# Install dependencies
npm install

# Build the project
npm run build

配置

此服务需要 Apollo.io API 访问令牌。你可以通过以下步骤获取：

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

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

1. 作为环境变量：

   APOLLO_IO_API_KEY=your-api-key
   

2. 作为命令行参数：

   npm start -- --api-key=your-api-key
   

在开发过程中，可在项目根目录创建 .env 文件来存储环境变量：

APOLLO_IO_API_KEY=your-api-key

使用方法

启动服务

# Start the server
npm start

# Or with a specific API key
npm start -- --api-key=your-api-key

# Run the SSE server with authentication
npx mcp-proxy-auth node dist/index.js

在 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 端点

与 AI 助手集成

此 MCP 服务专为支持 Model Context Protocol 的 AI 助手设计。服务运行后，会提供一组工具，兼容的 AI 助手可使用这些工具与 Apollo.io 数据交互。

可用工具

该服务提供以下强大的 Apollo.io 集成工具：

1. people_enrichment

   • 使用 People Enrichment 端点，为 1 位人员补充数据
   • 参数：
     • first_name（string，可选）：人员的名字
     • last_name（string，可选）：人员的姓氏
     • email（string，可选）：人员的电子邮箱地址
     • domain（string，可选）：公司域名
     • organization_name（string，可选）：组织名称
   • 示例：

     {
       "first_name": "John",
       "last_name": "Doe",
       "email": "[email protected]"
     }
     

2. organization_enrichment

   • 使用 Organization Enrichment 端点，为 1 家公司补充数据
   • 参数：
     • domain（string，可选）：公司域名
     • name（string，可选）：公司名称
   • 示例：

     {
       "domain": "apollo.io"
     }
     

3. people_search

   • 使用 People Search 端点查找人员
   • 参数：
     • q_organization_domains_list（array，可选）：要在其中搜索的组织域名列表
     • person_titles（array，可选）：要搜索的职位名称列表
     • person_seniorities（array，可选）：要搜索的资历级别列表
   • 示例：

     {
       "person_titles": ["Marketing Manager"],
       "person_seniorities": ["vp"],
       "q_organization_domains_list": ["apollo.io"]
     }
     

4. organization_search

   • 使用 Organization Search 端点查找组织
   • 参数：
     • q_organization_domains_list（array，可选）：要搜索的组织域名列表
     • organization_locations（array，可选）：要搜索的组织所在地列表
   • 示例：

     {
       "organization_locations": ["Japan", "Ireland"]
     }
     

5. organization_job_postings

   • 使用 Organization Job Postings 端点查找特定组织的招聘信息
   • 参数：
     • organization_id（string，必填）：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、Model Context Protocol、MCP、AI 助手、TypeScript、API 集成、Apollo.io API、People Enrichment、Organization Enrichment、People Search、Organization Search、Job Postings、AI 工具