关键词

Hunter APIB2B数据邮件查找公司信息潜在客户管理

项目简介

这是一个基于Model Context Protocol (MCP) 构建的服务器，旨在将Hunter.io的B2B数据和功能无缝集成到支持MCP协议的大型语言模型（LLM）应用中，例如Claude for Desktop。用户可以通过自然语言与LLM交互，间接调用Hunter API获取或管理B2B信息。

主要功能点

该服务器将Hunter API 的多个端点封装为LLM可调用的“工具”，主要功能包括：

  • 域名搜索: 查找指定域名下的常见邮箱地址。
  • 邮箱验证: 检查给定邮箱地址的有效性。
  • 邮箱查找: 根据域名和全名，查找最可能的邮箱地址。
  • 邮箱信息丰富: 获取与特定邮箱地址关联的个人信息（如姓名、位置、社交媒体）。
  • 公司信息丰富: 获取与特定域名关联的公司信息（如行业、描述、总部位置）。
  • 创建潜在客户: 在用户的Hunter账户中创建一个新的潜在客户（Lead），通常通过邮箱地址。

安装步骤

  1. 获取Hunter API Key: 在Hunter.io网站上注册并获取您的API Key。

  2. 安装Python: 确保您已安装 Python 3.13 或更高版本。

  3. 安装 uv: 这是一个快速的Python包管理器和构建工具。根据uv的安装指南进行安装。

  4. 下载项目代码: 将此Hunter MCP服务器的代码库克隆或下载到您的本地。

  5. 安装并运行服务器: 使用'uv'和'mcp'命令行工具安装并启动服务器。打开终端，切换到项目根目录，然后运行以下命令，将 'YOUR_HUNTER_API_KEY' 替换为您真实的API Key：

    mcp install main.py -v HUNTER_API_KEY=YOUR_HUNTER_API_KEY

    这条命令会自动安装所需的依赖，并将服务器注册到您的MCP客户端环境中。

服务器配置（供MCP客户端参考）

MCP客户端（如Claude Desktop）需要配置服务器的启动信息才能与之连接。以下是配置时所需的关键信息描述：

  • 服务器名称 (server name): hunter-mcp
  • 启动命令 (command): uv
  • 命令参数 (args): run, --with, mcp[cli], mcp, run, [服务器代码的main.py文件路径]
    • '[服务器代码的main.py文件路径]' 需要替换为您本地 'main.py' 文件的绝对或相对路径。
  • 环境变量 (env): 必须设置 'HUNTER_API_KEY' 环境变量，其值为您的Hunter API Key。

例如，在一个MCP客户端的配置文件中，可能需要类似如下的结构来指定如何启动此服务器（但请不要直接复制以下代码块，而是根据您的客户端界面或配置文件的具体格式进行配置）：

{
  "mcpServers": {
    "hunter-mcp": {
      "command": "uv",
      "args": [
        "run",
        "--with",
        "mcp[cli]",
        "mcp",
        "run",
        "/path/to/your/hunter-mcp/main.py" // 替换为实际路径
      ],
      "env": {
        "HUNTER_API_KEY": "您的Hunter API Key"
      }
    }
  }
}

注意：具体配置方式取决于您使用的MCP客户端。通常客户端会提供图形界面或特定的配置文件格式来添加和配置MCP服务器。上述 JSON 结构仅用于说明所需的配置信息及其含义。

基本使用方法

  1. 确保您的MCP客户端（如Claude Desktop）已识别并成功启动了猎人MCP服务器。
  2. 在MCP客户端中，通过与LLM进行自然语言对话来调用服务器提供的功能。例如，您可以问：“请帮我查找公司 'example.com' 的联系邮箱。” LLM 检测到您的意图后，会调用猎人MCP服务器的“域名搜索”工具，并将结果返回给您。
  3. 您可以尝试描述其他任务，如验证某个邮箱、查找特定人物邮箱或创建潜在客户，LLM将尝试通过相应的工具来满足您的请求。

信息

分类

商业系统

访问项目