Integração do Hunter MCP Server

O que faz o “Hunter” MCP Server?

O Hunter MCP Server fornece integração entre a API do Hunter e qualquer provedor de LLM que suporte o Model Context Protocol (MCP), como o Claude for Desktop. Este servidor permite que assistentes de IA acessem, consultem e manipulem dados B2B sobre pessoas e empresas da plataforma Hunter usando linguagem natural. Ao expor os poderosos endpoints da API do Hunter como ferramentas, o servidor simplifica fluxos de trabalho como busca de informações de domínio, localização e verificação de endereços de e-mail, enriquecimento de dados de empresas e gestão de leads. Essa integração estreita permite que desenvolvedores e profissionais de negócios automatizem tarefas de geração e enriquecimento de leads, possibilitando que agentes de IA interajam perfeitamente com conjuntos de dados B2B externos, aumentando assim a produtividade e acelerando processos de desenvolvimento de negócios.

Lista de Prompts

Não há modelos de prompts explícitos mencionados no repositório ou na documentação.

Lista de Recursos

Não há recursos MCP específicos listados no repositório ou na documentação.

Lista de Ferramentas

• Domain Search
  Permite buscar endereços de e-mail associados a um domínio específico.
• Email Finder
  Encontra o endereço de e-mail mais provável para uma pessoa e domínio informados.
• Email Verifier
  Verifica a validade e entregabilidade de um endereço de e-mail.
• Email Enrichment
  Recupera dados adicionais sobre um endereço de e-mail fornecido.
• Company Enrichment
  Fornece informações detalhadas sobre uma empresa específica.
• Lead Creation
  Permite salvar contatos e empresas como leads no Hunter.

Casos de Uso deste MCP Server

• Pesquisa de Domínio e Geração de Leads
  Automatize a descoberta de contatos e e-mails de empresas para campanhas de vendas e prospecção, pesquisando domínios e identificando pessoas-chave.
• Verificação de E-mails para Campanhas
  Valide endereços de e-mail antes de iniciar campanhas de marketing ou vendas para reduzir taxas de rejeição e melhorar a entregabilidade.
• Enriquecimento de Contatos e Empresas
  Reúna detalhes abrangentes sobre empresas e pessoas para construir perfis de clientes mais ricos em sistemas de CRM.
• Gestão Automatizada de Leads
  Adicione novos leads à plataforma Hunter via interfaces conversacionais de IA, otimizando fluxos de vendas.
• Integração de Dados B2B
  Integre dados B2B atualizados em aplicações personalizadas ou agentes de IA para impulsionar a tomada de decisão em tempo real e a personalização.

Como configurar

Windsurf

1. Certifique-se de ter o Python 3.13+ e o uv instalados.
2. Obtenha uma chave de API do Hunter.
3. Edite ou crie o arquivo de configuração do Windsurf.
4. Adicione o Hunter MCP Server usando o seguinte trecho JSON:

   {
     "mcpServers": {
       "hunter-mcp": {
         "command": "uv",
         "args": [
           "run",
           "--with",
           "mcp[cli]",
           "mcp",
           "run",
           "PATH_TO_hunter-mcp/main.py"
         ],
         "env": {
           "HUNTER_API_KEY": "YOUR_HUNTER_API_KEY"
         }
       }
     }
   }
   

5. Salve a configuração e reinicie o Windsurf.
6. Verifique se o servidor está em execução e acessível.

Claude

1. Certifique-se de que o Python 3.13+ e o uv estão instalados.
2. Obtenha sua chave de API do Hunter.
3. Execute o seguinte comando no seu terminal:

   mcp install main.py -v HUNTER_API_KEY=YOUR_HUNTER_API_KEY
   

4. Configure o Claude para conectar ao novo MCP server.
5. Teste o acesso invocando uma ferramenta do Hunter via Claude.

Cursor

1. Instale o Python 3.13+ e o uv.
2. Obtenha sua chave de API do Hunter.
3. Localize a configuração MCP nas configurações do Cursor.
4. Adicione o Hunter MCP Server conforme mostrado:

   {
     "mcpServers": {
       "hunter-mcp": {
         "command": "uv",
         "args": [
           "run",
           "--with",
           "mcp[cli]",
           "mcp",
           "run",
           "PATH_TO_hunter-mcp/main.py"
         ],
         "env": {
           "HUNTER_API_KEY": "YOUR_HUNTER_API_KEY"
         }
       }
     }
   }
   

5. Salve e reinicie o Cursor para habilitar o servidor.

Cline

1. Certifique-se de que o Python 3.13+ e o uv estão instalados.
2. Obtenha sua chave de API do Hunter.
3. Edite o arquivo de configuração MCP do Cline.
4. Insira o seguinte trecho:

   {
     "mcpServers": {
       "hunter-mcp": {
         "command": "uv",
         "args": [
           "run",
           "--with",
           "mcp[cli]",
           "mcp",
           "run",
           "PATH_TO_hunter-mcp/main.py"
         ],
         "env": {
           "HUNTER_API_KEY": "YOUR_HUNTER_API_KEY"
         }
       }
     }
   }
   

5. Salve as alterações e reinicie o Cline.

Protegendo Chaves de API

Sempre armazene chaves de API sensíveis como variáveis de ambiente, e não diretamente nos arquivos de configuração. Exemplo:

{
  "mcpServers": {
    "hunter-mcp": {
      "env": {
        "HUNTER_API_KEY": "${HUNTER_API_KEY}"
      },
      "inputs": {
        "HUNTER_API_KEY": "your-api-key"
      }
    }
  }
}

Como usar este MCP em fluxos

Usando o MCP no FlowHunt

Para integrar servidores MCP ao seu fluxo no FlowHunt, comece adicionando o componente MCP ao seu fluxo e conectando-o ao seu agente de IA:

Clique no componente MCP para abrir o painel de configuração. Na seção de configuração do sistema MCP, insira os detalhes do seu servidor MCP usando este formato JSON:

{
  "hunter-mcp": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

Uma vez configurado, o agente de IA poderá usar este MCP como uma ferramenta com acesso a todas as suas funções e capacidades. Lembre-se de alterar “hunter-mcp” para o nome real do seu servidor MCP e substituir a URL pela URL do seu MCP server.

Visão Geral

Nossa opinião

Este MCP server oferece uma integração sólida com a API do Hunter, tornando dados B2B e gestão de leads acessíveis a ferramentas baseadas em LLM. Contudo, faltam modelos de prompt documentados e primitivas de recursos, além de não mencionar recursos avançados do MCP como roots ou sampling. O código é open source com licença permissiva, mas o projeto ainda está em estágio inicial com engajamento modesto da comunidade. No geral, é uma boa escolha para usuários da API do Hunter que buscam compatibilidade com MCP, mas pode se beneficiar de mais documentação e suporte a recursos MCP.

Score MCP