AI导哈

Apollo.io MCP 服务器

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

  • by lkm1developer
  • TypeScript
  • 本地部署
  • 40 星标
  • 更新于
在 GitHub 查看 lkm1developer/apollo-io-mcp-server

使用说明

Apollo.io MCP 服务器

强大的模型上下文协议（MCP）服务器实现，实现Apollo.io API无缝集成，使人工智能助手能够与Apollo.io数据交互。

概述

该MCP服务器提供了一套全面的工具，用于与Apollo.io API交互，使人工智能助手能够：

  • 丰富个人和组织的数据
  • 搜索人员和组织
  • 查找特定组织的招聘信息
  • 在不离开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代理身份验证 用于身份验证的包。要实现身份验证，请执行以下操作：

  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服务器旨在与支持模型上下文协议的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. 人员搜索

    • 使用人员搜索端点查找人员
    • 参数：
      • 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. 向中添加新方法 ApolloClient 类在 src/apollo-client.ts
  2. 在中注册新工具 setupToolHandlers 方法in src/index.ts
  3. 使用重建项目 npm run build

许可证

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

关键词

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

相关 MCP