Job Tracker AI

Um servidor de chat com inteligência artificial para acompanhar processos de entrevistas de emprego, integrado ao Supabase.

GitHub

Documentação

Job Tracker MCP Server

Um servidor Model Context Protocol (MCP) para acompanhar processos de entrevista de emprego usando interação por chat com tecnologia de IA.

Visão Geral

Este serviço expõe ferramentas estruturadas (via MCP) que permitem aos usuários registrar, atualizar e consultar suas candidaturas de emprego em andamento, entrevistas, contatos e resultados — tudo por meio de conversas em linguagem natural com um LLM. Com o Supabase como base para prototipagem rápida e armazenamento persistente, ele é projetado para funcionar perfeitamente com LLMs como GPT Claude.

Recursos

  • Rastreamento Estruturado de Eventos
    • Candidaturas
    • Entrevistas
    • Ofertas
    • Follow-ups
  • Gerenciamento de Empresas e Cargos
    • Perfis de empresas
    • Detalhes e requisitos de cargos
  • Gerenciamento de Dados
    • Rastreamento de remuneração
    • Histórico de contatos
    • Atualizações de status de candidaturas
  • Assistência com IA
    • Perguntas e respostas com contexto
    • Interação em linguagem natural
    • Insights inteligentes

Design

O Job Tracker é construído com uma arquitetura moderna e escalável:

Infraestrutura de Backend

  • Backend Supabase
    • Banco de dados PostgreSQL para armazenamento de dados robusto
    • Segurança em Nível de Linha (RLS) para privacidade de dados
    • Autenticação integrada e gerenciamento de usuários

Componentes do Sistema

┌──────────────┐     ┌──────────────┐     ┌──────────────┐
│   LLM Chat   │────>│   MCP Tools  │────>│   Supabase   │
│  Interface   │     │   Server     │     │   Backend    │
└──────────────┘     └──────────────┘     └──────────────┘
  • Camada de Ferramentas MCP: Expõe endpoints estruturados para interação com LLM
  • Modelos de Dados:
    • Empresas
    • Cargos (candidaturas)
    • Eventos de Entrevista
    • Contatos

O sistema aproveita a arquitetura serverless do Supabase, eliminando a necessidade de manutenção tradicional de backend, ao mesmo tempo que oferece confiabilidade e segurança de nível empresarial.

Como Usar

Pré-requisitos

  1. Node.js instalado no seu sistema
  2. Uma conta e um projeto Supabase
  3. A URL do seu projeto Supabase e o token de usuário

Configuração no Seu Ambiente de Desenvolvimento de IA

  1. Adicione a seguinte configuração à configuração de servidores MCP do seu agente de IA:
{
  "mcpServers": {
    "job-tracker": {
      "command": "node",
      "args": ["<path-to-job-tracker>/dist/index.js", "access-token"]
    }
  }
}

Substitua os placeholders:

  • <path-to-job-tracker>: Caminho para o diretório job-tracker-mcp instalado
  • <access-token>: Seu token de acesso

Comandos Disponíveis

Depois de configurado, você pode interagir com o Job Tracker por meio de linguagem natural no seu chat de IA. Exemplos:

  • "Adicionar uma nova empresa para a qual estou me candidatando"
  • "Registrar uma nova entrevista para [empresa]"
  • "Atualizar o status da minha candidatura em [empresa]"
  • "Mostrar todas as minhas próximas entrevistas"
  • "Listar todas as empresas para as quais me candidatei"

A IA usará automaticamente as ferramentas MCP apropriadas para gerenciar seus dados de busca de emprego.

Exibindo Logs

O arquivo de log é gravado em mcp-tool.log no diretório inicial do seu usuário. Para visualizar os logs do aplicativo em tempo real, você pode usar o seguinte comando no seu terminal:

tail -f ~/.config/job-tracker-mcp/mcp-tool.log