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 功能

安装

# 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. 导航至设置 > 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 端点为一个人丰富数据
   • 参数：
     • first_name (字符串, 可选): 人的名字
     • last_name (字符串, 可选): 人的姓氏
     • email (字符串, 可选): 人的电子邮件地址
     • domain (字符串, 可选): 公司域名
     • organization_name (字符串, 可选): 组织名称
   • 示例：

     {
       "first_name": "John",
       "last_name": "Doe",
       "email": "john.doe@example.com"
     }
     

2. organization_enrichment

   • 使用 Organization Enrichment 端点为一家公司丰富数据
   • 参数：
     • domain (字符串, 可选): 公司域名
     • name (字符串, 可选): 公司名称
   • 示例：

     {
       "domain": "apollo.io"
     }
     

3. people_search

   • 使用 People Search 端点查找人员
   • 参数：
     • q_organization_domains_list (数组, 可选): 要搜索的组织域名列表
     • person_titles (数组, 可选): 要搜索的职位列表
     • person_seniorities (数组, 可选): 要搜索的职级列表
   • 示例：

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

4. organization_search

   • 使用 Organization Search 端点查找组织
   • 参数：
     • q_organization_domains_list (数组, 可选): 要搜索的组织域名列表
     • organization_locations (数组, 可选): 要搜索的组织位置列表
   • 示例：

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

5. organization_job_postings

   • 使用 Organization Job Postings 端点查找特定组织的工作岗位发布
   • 参数：
     • 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 工具