阿波罗-io-mcp服务器

Name: 阿波罗-io-mcp服务器
Author: lkm1developer

作者：lkm1developer29 星标更新：2025-04-18

安装使用来源：spider==github.com

项目介绍

Apollo.io MCP Server

一个强大的模型上下文协议（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功能

安装

# 克隆仓库
git clone https://github.com/lkm1developer/apollo-io-mcp-server.git
cd apollo-io-mcp-server

# 安装依赖
npm install

# 构建项目
npm run build

配置

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

前往您的Apollo.io账户
导航至设置 > API
生成一个API密钥

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

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

对于开发，可以在项目根目录创建一个.env文件来存储环境变量：

APOLLO_IO_API_KEY=your-api-key

使用

启动服务器

# 启动服务器
npm start

# 或者使用特定的API密钥
npm start -- --api-key=your-api-key

# 运行带有身份验证的SSE服务器
npx mcp-proxy-auth node dist/index.js

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

SSE服务器使用mcp-proxy-auth包进行身份验证。要实现身份验证：

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

mcp-proxy-auth包充当代理，它：

截获对您的SSE服务器的请求
将API密钥与您的身份验证服务器进行验证
只允许经过身份验证的请求到达您的SSE端点

与AI助手集成

此MCP服务器旨在与支持模型上下文协议的AI助手一起工作。一旦运行，服务器会暴露一组工具，这些工具可以被兼容的AI助手用来与Apollo.io数据进行交互。

可用工具

服务器暴露了以下强大的Apollo.io集成工具：

people_enrichment
- 使用People Enrichment端点来丰富1个人的数据
- 参数：
  - first_name (字符串，可选)：人的名字
  - last_name (字符串，可选)：人的姓氏
  - email (字符串，可选)：人的电子邮件地址
  - domain (字符串，可选)：公司域名
  - organization_name (字符串，可选)：组织名称
- 示例：
```
{
  "first_name": "John",
  "last_name": "Doe",
  "email": "john.doe@example.com"
}
```
organization_enrichment
- 使用Organization Enrichment端点来丰富1个公司的数据
- 参数：
  - domain (字符串，可选)：公司域名
  - name (字符串，可选)：公司名称
- 示例：
```
{
  "domain": "apollo.io"
}
```
people_search
- 使用People Search端点来查找人员
- 参数：
  - q_organization_domains_list (数组，可选)：要在其中搜索的组织域名列表
  - person_titles (数组，可选)：要搜索的职位头衔列表
  - person_seniorities (数组，可选)：要搜索的高级程度列表
- 示例：
```
{
  "person_titles": ["市场营销经理"],
  "person_seniorities": ["vp"],
  "q_organization_domains_list": ["apollo.io"]
}
```
organization_search
- 使用Organization Search端点来查找组织
- 参数：
  - q_organization_domains_list (数组，可选)：要搜索的组织域名列表
  - organization_locations (数组，可选)：要搜索的组织地点列表
- 示例：
```
{
  "organization_locations": ["日本", "爱尔兰"]
}
```
organization_job_postings
- 使用Organization Job Postings端点来查找特定组织的工作岗位发布
- 参数：
  - organization_id (字符串，必需)：Apollo.io组织ID
- 示例：
```
{
  "organization_id": "5e60b6381c85b4008c83"
}
```

扩展服务器

服务器设计易于扩展。要添加新的Apollo.io API功能：

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

许可证

本项目采用MIT许可证 - 详情见LICENSE文件。

关键词

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