Apollo.io MCP 服务器

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

概述

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

• 丰富个人和组织的数据

• 搜索人员和组织

• 查找特定组织的招聘信息

• 无需离开 AI 助手界面即可执行 Apollo.io 操作

Related MCP server: MCP Toolkit

为什么要使用此 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 端点

与人工智能助手集成

此 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 工具