GitHunt

githunt-mcp

Um servidor MCP que dá ao seu assistente de IA uma visão de recrutador do GitHub. Ele envolve a API do GitHunt para que Claude, Cursor e outros clientes MCP possam pesquisar um pool pré-indexado de desenvolvedores do GitHub, consultar um perfil classificado e executar uma análise profunda de IA sobre um candidato - tudo a partir de um prompt de chat.

Pergunte "encontre engenheiros de backend em Berlim que conheçam Go e Kubernetes" e receba uma lista classificada e pontuada com sinais de atividade e informações de contato.

Prefere configuração zero? O GitHunt também executa um servidor MCP hospedado em https://mcp.githunt.ai/mcp. Adicione-o como um conector personalizado no Claude (Configurações -> Conectores) ou como um servidor MCP remoto no seu cliente e faça login com sua conta GitHunt - sem necessidade de chave de API ou processo local. Este pacote é a alternativa auto-hospedada (stdio).

Início rápido

1. Obtenha uma chave de API da sua conta GitHunt.

2. Execute o servidor:

   GITHUNT_API_KEY=your-key-here npx githunt-mcp
   

3. Conecte-o ao seu cliente (veja abaixo) e é só perguntar.

Variáveis de ambiente

Variável	Obrigatório	Descrição
GITHUNT_API_KEY	sim	Sua chave de API do GitHunt
GITHUNT_API_URL	não	URL base da API (padrão https://api.githunt.ai)

Claude Code

claude mcp add githunt -e GITHUNT_API_KEY=your-key-here -- npx githunt-mcp

Claude Desktop

Adicione a claude_desktop_config.json:

{
  "mcpServers": {
    "githunt": {
      "command": "npx",
      "args": ["githunt-mcp"],
      "env": {
        "GITHUNT_API_KEY": "your-key-here"
      }
    }
  }
}

Cursor

Adicione a .cursor/mcp.json:

{
  "mcpServers": {
    "githunt": {
      "command": "npx",
      "args": ["githunt-mcp"],
      "env": {
        "GITHUNT_API_KEY": "your-key-here"
      }
    }
  }
}

Qualquer cliente MCP que fale stdio funciona da mesma forma: execute npx githunt-mcp com GITHUNT_API_KEY no ambiente.

Experimente

Depois de conectado, pergunte ao seu assistente naturalmente:

• "Encontre desenvolvedores frontend seniores em Varsóvia que conheçam React e TypeScript."
• "Mostre-me engenheiros DevOps contratáveis na Polônia com mais de 5 anos no GitHub."
• "Dê-me os próximos 25 candidatos para essa busca." (paginação via offset)
• "Puxe o perfil GitHunt do octocat."
• "Faça uma análise profunda do torvalds - proficiência, papéis mais adequados, e-mails públicos."
• "Busque engenheiros de ML em São Francisco e analise seus 3 principais."

Ferramentas

Ferramenta	O que faz	Velocidade
search_developers	Pesquise o pool pré-indexado do GitHunt por location, role, skills, languages e mais. Retorna candidatos classificados por adequação com pontuações, atividade e informações de contato. Paginação via offset (0-200). Retorna uma tabela markdown além de JSON estruturado. Se uma localização não corresponder a nada, sugere localizações suportadas semelhantes em vez de uma página vazia.	Rápido (servido do pool, sem rastreamento ao vivo)
get_developer	Obtenha o perfil classificado de um desenvolvedor por login/username: pontuações geral, de perfil, de stack de tecnologia e de atividade, experiência, atividade de commits, principais repositórios e informações de contato.	Rápido (cache-first)
analyze_profile	Análise profunda de IA de um perfil a partir de dados ao vivo do GitHub: nível de proficiência, papéis mais adequados e e-mails extraídos. Use para avaliar um candidato pré-selecionado.	Mais lento (rastreamento ao vivo)

Valores suportados de role: fullstack, frontend, backend, mobile, devops, ai-engineer, ai-orchestrator, ml-engineer, data-scientist, data-engineer, security, cloud, blockchain, embedded, gamedev, ios-developer, android-developer, sre, platform-engineer, qa-engineer, solutions-architect, cto, vp-engineering, head-engineering, engineering-manager, tech-lead, product-manager, director-engineering.

Habilidades são correspondidas com sinônimos (k8s -> kubernetes), e localizações são normalizadas (SF, NYC, UK, Warszawa).

Referência completa da API: https://docs.githunt.ai

Pontuação

Cada candidato carrega uma pontuação geral construída a partir de três dimensões, todas exibidas em get_developer:

• Pontuação de perfil - bio, sinais de senioridade e maturidade da conta.
• Pontuação de stack de tecnologia - quão bem suas linguagens e repositórios correspondem às habilidades e ao papel solicitados.
• Pontuação de atividade - recência e volume de contribuições públicas (commits, frequência, qualidade das mensagens de commit).

search_developers classifica o pool por adequação à sua consulta; analyze_profile recalcula proficiência e adequação ao papel com base em dados frescos do GitHub.

Cotas

As solicitações contam contra a cota do seu plano GitHunt. Cada resposta inclui seu uso atual (used / limit do mês), e um erro quota_exceeded informa quando você atingiu o limite. Veja sua conta para limites do plano.

Limitações e uso responsável

O GitHunt lê atividade pública do GitHub, que é uma forte evidência de trabalho técnico, mas está longe de ser o quadro completo:

• Ele é cego para contribuições em repositórios privados, internos e corporativos - muitos engenheiros excelentes têm perfis públicos silenciosos.
• O pool de candidatos é pré-indexado, então contas novas ou raramente ativas podem estar ausentes; analyze_profile busca dados ao vivo para uma pessoa específica.
• Sinais de atividade pública podem ser distorcidos por geografia, empregador e estágio de carreira.

Use isso como um gerador de leads, não um filtro automatizado. Trate as pontuações como um ponto de partida para uma conversa humana, não como uma decisão de contratação. GitHub não é o engenheiro inteiro.

Contribuindo

Issues e pull requests são bem-vindos. Por favor, abra uma issue descrevendo a mudança antes de enviar um PR grande. Para comportamento da API e detalhes de endpoints, veja https://docs.githunt.ai.

Licença

MIT - veja LICENSE.