gupy-candidate-mcp

<p align="center"> <img src="banner.png" alt="gupy candidate — servidor MCP para empregabilidade orientada por IA" width="100%"> </p>

<p align="center"> <strong>Servidor MCP que transforma vagas do Gupy em dados, análise e templates de preparação para a sua IA.</strong> </p>

<p align="center"> <a href="https://github.com/leonardobora/gupy-candidate-mcp/blob/main/LICENSE"><img src="https://img.shields.io/github/license/leonardobora/gupy-candidate-mcp?color=7c3aed&style=flat-square" alt="License"></a> <a href="https://github.com/leonardobora/gupy-candidate-mcp/actions"><img src="https://img.shields.io/github/actions/workflow/status/leonardobora/gupy-candidate-mcp/ci.yml?branch=main&label=ci&style=flat-square" alt="CI"></a> <a href="https://github.com/leonardobora/gupy-candidate-mcp/issues"><img src="https://img.shields.io/github/issues/leonardobora/gupy-candidate-mcp?style=flat-square" alt="Issues"></a> <a href="https://github.com/leonardobora/gupy-candidate-mcp/pulls"><img src="https://img.shields.io/github/issues-pr/leonardobora/gupy-candidate-mcp?style=flat-square" alt="Pull Requests"></a> <a href="https://github.com/leonardobora/gupy-candidate-mcp"><img src="https://img.shields.io/github/stars/leonardobora/gupy-candidate-mcp?style=flat-square" alt="Stars"></a> <a href="https://github.com/leonardobora/gupy-candidate-mcp"><img src="https://img.shields.io/github/last-commit/leonardobora/gupy-candidate-mcp?style=flat-square" alt="Last commit"></a> </p>

O gupy candidate é um servidor MCP que ajuda pessoas candidatas a se candidatarem a vagas hospedadas no Gupy. Ele entrega dados + análise + templates de preparação para a sua IA (opencode, Claude, Gemini CLI etc.) — o raciocínio e a redação ficam na IA cliente. Nenhuma chave de LLM é embutida.

Empregabilidade orientada por IA, não "corrida atrás de vaga". Este projeto não se candidata no seu nome nem decide por você — ele te entrega dados reais das vagas e um ponto de partida, para que você entenda onde se encaixa e chegue melhor preparado. É uma ferramenta de capacitação, com transparência sobre como a IA pode (e não pode) ajudar na sua jornada de candidatura.

O que faz

Tool	Descrição
buscar_vagas	Busca vagas públicas no Gupy (termo, estado, modalidade, tipo, empresa).
detalhe_vaga	Lê os detalhes de uma vaga pelo ID.
carregar_perfil	Carrega e valida o perfil do candidato a partir de um arquivo JSON.
analisar_aderencia	Cruza perfil x requisitos da vaga e gera score e pontos fortes/atenção.
preparar	Gera o template de prompt para curriculo, carta ou formulario.
monitorar	Verifica prazos de candidatura (urgente/proximo/ok).

Como usar

npm install
npm run build

Perfil do candidato: crie um JSON no formato de src/schema/profile.schema.json e passe o caminho para carregar_perfil / analisar_aderencia / preparar.

Para registrar no opencode, adicione ao seu opencode.json:

"gupy-candidate": {
  "type": "local",
  "command": ["node", "C:\\caminho\\ate\\gupy-candidate-mcp\\dist\\index.js"],
  "enabled": true
}

Desenvolvimento

npm test        # rodar testes
npm run build   # compilar
npm run dev     # watch mode (tsx)

---

<p align="center"> <small>Feito por <a href="https://github.com/leonardobora">Leonardo Bora</a> · MIT License</small> </p>