Resume Generator

Gera currículos profissionais em PDF usando templates LaTeX.

GitHub
22

Documentação

Resume Generator MCP Server (Descontinuado)

[!IMPORTANT] Este servidor MCP não é mais mantido. O Resumake e o serviço hospedado de renderização de currículos usado por este projeto foram descontinuados, portanto esta implementação não pode mais gerar PDFs através do seu endpoint original.

A lógica funcional de personalização e renderização de currículos foi movida para a habilidade tailor-resume. A habilidade executa os geradores LaTeX originais do Resumake v2 localmente, suporta todos os nove templates e não depende do endpoint hospedado descontinuado.

Para novas instalações e instruções de uso, use o repositório de habilidades mantido:

AndreaCadonna/skills - tailor-resume

Documentação MCP arquivada

A documentação abaixo é mantida para referência histórica e de migração. Comandos e exemplos que chamam a API LaTeX Resume não estão mais operacionais.

Um servidor MCP (Model Context Protocol) que gera currículos PDF profissionais usando templates LaTeX. Integra-se perfeitamente com o Claude Desktop para criar currículos refinados a partir de dados estruturados, com recursos avançados de gerenciamento de pastas e organização.

Resume Generator License

Recursos

  • 🎨 9 Templates Profissionais - Alimentado por designs LaTeX de alta qualidade
  • 📄 Geração de PDF - Saída de nível profissional via API LaTeX Resume
  • 🔧 Integração MCP - Funciona diretamente com o Claude Desktop
  • 📝 Dados Estruturados - Esquema JSON fácil de usar para dados de currículo
  • 🎯 Personalizável - Cabeçalhos, seções e seleção de template personalizados
  • 💼 Qualidade Profissional - Renderização baseada em LaTeX para resultados nítidos e profissionais
  • 🤖 Alimentado por IA - Criação de currículos em linguagem natural através do Claude
  • 📁 Gerenciamento de Pastas - Crie pastas personalizadas e organize currículos por vaga, empresa ou categoria
  • 🗂️ Navegação de Diretórios - Liste e navegue pela sua coleção de currículos com explorador de arquivos integrado
  • 🛡️ Caminhos Seguros - Sanitização de caminhos integrada previne problemas de segurança

Visão Geral

Este servidor MCP atua como uma ponte entre o Claude Desktop e a geração profissional de currículos. Basta descrever seus requisitos de currículo em linguagem natural para o Claude, e ele gerará um currículo PDF lindamente formatado usando templates LaTeX. Agora com recursos avançados de organização para manter seus currículos perfeitamente organizados!

Pré-requisitos

  • Node.js (v16 ou superior)
  • Aplicativo Claude Desktop
  • Conexão com a internet (para a API LaTeX Resume)

Instalação

  1. Clone o repositório:

    git clone https://github.com/yourusername/resume-generator-mcp.git
cd resume-generator-mcp

  2. Instale as dependências:

    npm install

  3. Configure o Claude Desktop: Adicione o seguinte ao arquivo de configurações MCP do seu Claude Desktop:

    Windows: %APPDATA%\Claude\claude_desktop_config.json macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Linux: ~/.config/Claude/claude_desktop_config.json

    {
  "mcpServers": {
    "resume-generator": {
      "command": "node",
      "args": ["path/to/resume-generator-mcp/server.js"]
    }
  }
}

  4. Reinicie o Claude Desktop para carregar o servidor MCP.

Uso

Uma vez configurado, você pode usar o gerador de currículos diretamente no Claude Desktop com linguagem natural. A ferramenta foi projetada para ser flexível e inteligente - você pode fornecer seu histórico profissional completo e deixar o Claude criar o currículo perfeito para qualquer situação.

Como Funciona

  1. Compartilhe sua Experiência - Forneça ao Claude seu histórico profissional completo, educação, habilidades e conquistas
  2. Especifique seu Objetivo - Opcionalmente, inclua uma descrição de vaga ou mencione o tipo de função que você está buscando
  3. Organize seus Currículos - Escolha onde salvar cada currículo com estruturas de pastas personalizadas
  4. Obtenha Resultados Personalizados - O Claude selecionará e destacará automaticamente as experiências mais relevantes para seu objetivo específico

Exemplos de Solicitações

Geração Básica de Currículo

Create a resume for a software engineer with 5 years experience in React and Node.js

Currículo Organizado com Pasta Personalizada

Generate a resume for a Senior Developer position at Google and save it in a "FAANG-applications/google" folder

Histórico Pessoal + Função Alvo + Organização

Here's my background:
- 8 years as a software developer
- Worked at: Microsoft (2018-2021), Google (2021-2023), startup CTO (2023-present)
- Skills: Python, JavaScript, AWS, team leadership, architecture design
- Education: MS Computer Science from MIT
- Led teams of 5-15 people, built systems serving millions of users

I'm applying for this Senior Engineering Manager position at Netflix:
[paste job description here]

Generate a resume that highlights my most relevant experience for this role and save it in "streaming-companies/netflix" folder.

Gerenciamento de Pastas

Create a folder structure for organizing my job applications: "job-search-2024/tech-companies" and "job-search-2024/startups"

Show me what resumes I have in my "tech-companies" folder

Geração com Template Específico e Organização

Generate a resume using template 3 for John Doe and save it in the "personal/drafts" folder with the filename "john-doe-senior-dev"

Cenários de Mudança de Carreira com Organização

I have 10 years in finance but want to transition to product management. Here's my experience:
[detailed background]

Create a resume that emphasizes my transferable skills for a Product Manager role at a tech company and save it in "career-transition/product-management" folder.

Recursos Inteligentes de Organização

  • 🗂️ Criação Automática de Pastas - Pastas são criadas automaticamente ao gerar currículos
  • 📁 Estrutura de Diretórios Personalizada - Organize por empresa, tipo de função, setor ou qualquer sistema que funcione para você
  • 🔍 Navegador de Diretórios - Liste o conteúdo de qualquer pasta para ver sua coleção de currículos
  • 📊 Informações de Arquivo - Veja tamanhos de arquivo, datas de criação e organize por metadados
  • 🛡️ Segurança de Caminhos - Sanitização integrada previne travessia de diretórios e caracteres inválidos

Exemplos de Organização

Por Empresa:

  • applications/google/
  • applications/microsoft/
  • applications/amazon/

Por Tipo de Função:

  • roles/senior-engineer/
  • roles/tech-lead/
  • roles/manager/

Por Setor:

  • industries/fintech/
  • industries/healthcare/
  • industries/gaming/

Por Status:

  • drafts/
  • submitted/2024/
  • archived/old-versions/

Recursos Inteligentes de Personalização

  • 🎯 Otimização de Relevância - Prioriza automaticamente experiências que correspondem à função alvo
  • 📈 Destaque de Conquistas - Enfatiza resultados quantificáveis e realizações
  • 🔄 Alinhamento de Habilidades - Combina suas habilidades com os requisitos da vaga quando fornecidos
  • 📝 Formatação Profissional - Garante formatação consistente e compatível com ATS
  • 🎨 Seleção de Template - Recomenda o melhor template para seu setor/função

O Claude estruturará automaticamente suas informações e gerará um currículo PDF profissional adaptado aos seus objetivos específicos, salvando-o exatamente onde você quiser.

Referência da API

Ferramentas Disponíveis

generate_resume

Gera um currículo PDF a partir de dados estruturados com organização opcional de pastas.

Parâmetros:

  • resumeData (objeto): Informações completas do currículo
  • filename (string, opcional): Nome de arquivo personalizado para o PDF
  • folderPath (string, opcional): Caminho de pasta personalizado dentro do diretório generated-resumes

Exemplo:

{
  "resumeData": {
    /* resume data */
  },
  "filename": "john-doe-senior-engineer",
  "folderPath": "job-applications/tech-companies/google"
}

create_folder

Cria uma nova pasta dentro do diretório generated-resumes.

Parâmetros:

  • folderPath (string): Caminho da pasta a ser criada (suporta pastas aninhadas)

Exemplo:

{
  "folderPath": "applications/2024/q1"
}

list_folders

Lista todas as pastas e arquivos no diretório generated-resumes.

Parâmetros:

  • path (string, opcional): Subdiretório específico a ser listado

Exemplo:

{
  "path": "applications/tech-companies"
}

create_resume_template

Cria uma estrutura de template com dados de exemplo.

Parâmetros:

  • templateNumber (inteiro, 1-9): Template a ser usado como base

Estrutura de Dados do Currículo

{
  "selectedTemplate": 1,
  "basics": {
    "name": "John Doe",
    "email": "john.doe@example.com",
    "phone": "+1-555-0123",
    "website": "https://johndoe.dev",
    "location": {
      "address": "San Francisco, CA"
    }
  },
  "work": [
    {
      "company": "Tech Corp",
      "position": "Software Engineer",
      "location": "San Francisco, CA",
      "startDate": "2022",
      "endDate": "Present",
      "highlights": [
        "Developed web applications using React and Node.js",
        "Led team of 3 developers on key projects"
      ]
    }
  ],
  "education": [
    {
      "institution": "University of California",
      "area": "Computer Science",
      "studyType": "Bachelor of Science",
      "startDate": "2018",
      "endDate": "2022",
      "location": "Berkeley, CA"
    }
  ],
  "skills": [
    {
      "name": "Frontend",
      "keywords": ["React", "TypeScript", "HTML5", "CSS3"]
    }
  ],
  "projects": [
    {
      "name": "Portfolio Website",
      "description": "Personal portfolio built with Next.js",
      "url": "https://johndoe.dev",
      "keywords": ["Next.js", "React", "Tailwind CSS"]
    }
  ]
}

Configuração

Armazenamento de Arquivos

Os PDFs gerados são salvos em diretórios organizados dentro de:

  • Windows: %LOCALAPPDATA%\AnthropicClaude\app-{version}\generated-resumes\
  • macOS: ~/Library/Application Support/AnthropicClaude/app-{version}/generated-resumes/
  • Linux: ~/.local/share/AnthropicClaude/app-{version}/generated-resumes/

Exemplo de Estrutura de Diretórios

generated-resumes/
├── applications/
│   ├── google/
│   │   ├── john-doe-swe-2024-06-30.pdf
│   │   └── john-doe-senior-2024-06-30.pdf
│   ├── microsoft/
│   └── startups/
├── drafts/
│   └── work-in-progress-2024-06-30.pdf
└── templates/
    └── base-template-2024-06-30.pdf

Solução de Problemas

Problemas Comuns

  1. Erros de "Método não encontrado":

    • Certifique-se de que o Claude Desktop foi reiniciado após a configuração
    • Verifique se o caminho em claude_desktop_config.json está correto

  2. Erros de conexão:

    • Verifique a conexão com a internet
    • Verifique se a API LaTeX Resume está acessível

  3. PDF não gerado:

    • Verifique as permissões do diretório generated-resumes
    • Certifique-se de que o diretório existe e é gravável

  4. Erros de criação de pastas:

    • Verifique as permissões de escrita no diretório generated-resumes
    • Verifique se os caminhos das pastas não contêm caracteres inválidos

  5. Problemas relacionados a caminhos:

    • Os caminhos das pastas são automaticamente sanitizados por segurança
    • Caracteres inválidos são substituídos por sublinhados
    • Tentativas de travessia de diretórios (../) são bloqueadas automaticamente

Modo de Depuração

Ative o registro de depuração definindo a variável de ambiente:

DEBUG=resume-generator node server.js

Desenvolvimento

Estrutura do Projeto

resume-generator-mcp/
├── server.js              # Main MCP server with folder management
├── package.json           # Dependencies and scripts
├── README.md              # This file
└── generated-resumes/     # Output directory (created automatically)
    └── [organized folders] # Custom folder structure

Dependências

  • @modelcontextprotocol/sdk: SDK MCP para implementação do servidor
  • node-fetch: Cliente HTTP para requisições de API
  • fs/promises: Operações de sistema de arquivos para gerenciamento de pastas

Recursos de Segurança

  • Sanitização de Caminhos: Previne ataques de travessia de diretórios
  • Validação de Entrada: Valida caminhos de pastas e nomes de arquivos
  • Limitação de Escopo: Todas as operações são confinadas ao diretório generated-resumes
  • Filtragem de Caracteres: Remove ou substitui caracteres inválidos do sistema de arquivos

Contribuindo

  1. Faça um fork do repositório
  2. Crie um branch de funcionalidade: git checkout -b feature-name
  3. Faça suas alterações e teste minuciosamente
  4. Envie um pull request com uma descrição clara

Créditos

Este projeto é construído sobre vários projetos e serviços incríveis de código aberto:

API LaTeX Resume

  • Serviço: latexresu.me - API profissional de geração de currículos LaTeX
  • Créditos: Agradecemos à equipe da API LaTeX Resume por fornecer o serviço de backend que alimenta a geração de PDF

Templates LaTeX

Os belos templates de currículo são baseados em designs de resumake.io e da comunidade LaTeX em geral:

Pilha de Tecnologia

  • MCP (Model Context Protocol) - Anthropic para a especificação do protocolo
  • Claude Desktop - Plataforma de integração para ferramentas alimentadas por IA
  • Node.js - Ambiente de execução para gerenciamento de pastas e operações de arquivos
  • LaTeX - Sistema de preparação de documentos para tipografia de alta qualidade

Licença

MIT © Contribuidores do Resume Generator

Suporte

Changelog

v2.0.0 - Atualização de Gerenciamento de Pastas

  • ✨ NOVO: Organização de pastas personalizadas dentro do diretório generated-resumes
  • ✨ NOVO: Ferramenta create_folder para criar estruturas de diretórios organizadas
  • ✨ NOVO: Ferramenta list_folders para navegar e gerenciar coleções de currículos
  • ✨ NOVO: generate_resume aprimorado com parâmetro folderPath
  • 🛡️ NOVO: Sanitização de caminhos e recursos de segurança
  • 📊 NOVO: Exibição de metadados de arquivos (tamanho, data) nas listagens de diretórios
  • 🗂️ NOVO: Criação automática de caminhos de pastas ao gerar currículos
  • 📁 NOVO: Suporte para estruturas de pastas aninhadas
  • 🔍 NOVO: Ferramentas de navegação de diretórios e organização de arquivos

v1.0.0

  • Lançamento inicial
  • Suporte para 9 templates LaTeX via API LaTeX Resume
  • Geração de currículos em linguagem natural através do Claude Desktop
  • Implementação de servidor MCP com suporte a dados estruturados
  • Saída PDF profissional com templates personalizáveis

Feito com ❤️ para a comunidade Claude Desktop e MCP