Resume Generator

Servidor MCP Resume Generator (Descontinuado)

[!IMPORTANT] Este servidor MCP ya no recibe mantenimiento. Resumake y el servicio de renderizado de currículums alojado utilizado por este proyecto han sido descontinuados, por lo que esta implementación ya no puede generar PDFs a través de su endpoint original.

La lógica funcional de adaptación y renderizado de currículums se ha trasladado a la habilidad tailor-resume. La habilidad ejecuta los generadores LaTeX originales de Resumake v2 localmente, admite las nueve plantillas y no depende del endpoint alojado descontinuado.

Para nuevas instalaciones e instrucciones de uso, utiliza el repositorio de habilidades mantenido:

AndreaCadonna/skills - tailor-resume

Documentación MCP archivada

La documentación a continuación se conserva como referencia histórica y de migración. Los comandos y ejemplos que llaman a la API de currículums LaTeX ya no están operativos.

Un servidor de Model Context Protocol (MCP) que genera currículums PDF profesionales utilizando plantillas LaTeX. Se integra perfectamente con Claude Desktop para crear currículums pulidos a partir de datos estructurados, con funciones avanzadas de gestión y organización de carpetas.

Características

• 🎨 9 Plantillas profesionales - Impulsadas por diseños LaTeX de alta calidad
• 📄 Generación de PDF - Salida de nivel profesional mediante la API de currículums LaTeX
• 🔧 Integración MCP - Funciona directamente con Claude Desktop
• 📝 Datos estructurados - Esquema JSON fácil de usar para los datos del currículum
• 🎯 Personalizable - Encabezados, secciones y selección de plantilla personalizados
• 💼 Calidad profesional - Renderizado basado en LaTeX para resultados nítidos y profesionales
• 🤖 Impulsado por IA - Creación de currículums en lenguaje natural a través de Claude
• 📁 Gestión de carpetas - Crea carpetas personalizadas y organiza currículums por puesto, empresa o categoría
• 🗂️ Navegación de directorios - Lista y explora tu colección de currículums con un explorador de archivos integrado
• 🛡️ Rutas seguras - El saneamiento de rutas integrado previene problemas de seguridad

Descripción general

Este servidor MCP actúa como un puente entre Claude Desktop y la generación profesional de currículums. Simplemente describe tus requisitos de currículum en lenguaje natural a Claude, y generará un currículum PDF bellamente formateado utilizando plantillas LaTeX. Ahora con funciones avanzadas de organización para mantener tus currículums perfectamente organizados.

Requisitos previos

• Node.js (v16 o superior)
• Aplicación Claude Desktop
• Conexión a Internet (para la API de currículums LaTeX)

Instalación

1. Clona el repositorio:

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

2. Instala las dependencias:

   npm install
   

3. Configura Claude Desktop: Agrega lo siguiente al archivo de configuración MCP de 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. Reinicia Claude Desktop para cargar el servidor MCP.

Uso

Una vez configurado, puedes usar el generador de currículums directamente en Claude Desktop con lenguaje natural. La herramienta está diseñada para ser flexible e inteligente: puedes proporcionar tu historial laboral completo y dejar que Claude elabore el currículum perfecto para cualquier situación.

Cómo funciona

1. Comparte tu experiencia - Proporciona a Claude tu historial profesional completo, educación, habilidades y logros
2. Especifica tu objetivo - Opcionalmente, incluye una descripción del puesto o menciona el tipo de rol al que te diriges
3. Organiza tus currículums - Elige dónde guardar cada currículum con estructuras de carpetas personalizadas
4. Obtén resultados adaptados - Claude seleccionará y destacará automáticamente las experiencias más relevantes para tu objetivo específico

Ejemplos de solicitudes

Generación básica de currículum

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

Currículum organizado con carpeta personalizada

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

Historial personal + Puesto objetivo + Organización

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.

Gestión de carpetas

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

Generación con plantilla específica y organización

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

Escenarios de cambio de carrera con organización

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.

Funciones inteligentes de organización

• 🗂️ Creación automática de carpetas - Las carpetas se crean automáticamente al generar currículums
• 📁 Estructura de directorios personalizada - Organiza por empresa, tipo de rol, industria o cualquier sistema que funcione para ti
• 🔍 Explorador de directorios - Lista el contenido de cualquier carpeta para ver tu colección de currículums
• 📊 Información de archivos - Consulta tamaños de archivo, fechas de creación y organiza por metadatos
• 🛡️ Seguridad de rutas - El saneamiento integrado previene el recorrido de directorios y caracteres no válidos

Ejemplos de organización

Por empresa:

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

Por tipo de rol:

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

Por industria:

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

Por estado:

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

Funciones inteligentes de adaptación

• 🎯 Optimización de relevancia - Prioriza automáticamente las experiencias que coinciden con el rol objetivo
• 📈 Destacar logros - Enfatiza resultados cuantificables y logros
• 🔄 Alineación de habilidades - Relaciona tus habilidades con los requisitos del puesto cuando se proporcionan
• 📝 Formato profesional - Garantiza un formato consistente y compatible con ATS
• 🎨 Selección de plantilla - Recomienda la mejor plantilla para tu industria/rol

Claude estructurará automáticamente tu información y generará un currículum PDF profesional adaptado a tus objetivos específicos, guardándolo exactamente donde quieras.

Referencia de la API

Herramientas disponibles

generate_resume

Genera un currículum PDF a partir de datos estructurados con organización de carpetas opcional.

Parámetros:

• resumeData (objeto): Información completa del currículum
• filename (cadena, opcional): Nombre de archivo personalizado para el PDF
• folderPath (cadena, opcional): Ruta de carpeta personalizada dentro del directorio de currículums generados

Ejemplo:

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

create_folder

Crea una nueva carpeta dentro del directorio de currículums generados.

Parámetros:

• folderPath (cadena): Ruta de carpeta a crear (admite carpetas anidadas)

Ejemplo:

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

list_folders

Lista todas las carpetas y archivos en el directorio de currículums generados.

Parámetros:

• path (cadena, opcional): Subdirectorio específico para listar

Ejemplo:

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

create_resume_template

Crea una estructura de plantilla con datos de ejemplo.

Parámetros:

• templateNumber (entero, 1-9): Plantilla a utilizar como base

Estructura de datos del currículum

{
  "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"]
    }
  ]
}

Configuración

Almacenamiento de archivos

Los PDF generados se guardan en directorios 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/

Ejemplo de estructura de directorios

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

Solución de problemas

Problemas comunes

1. Errores de "Método no encontrado":

   • Asegúrate de que Claude Desktop se reinicie después de la configuración
   • Verifica que la ruta en claude_desktop_config.json sea correcta

2. Errores de conexión:

   • Verifica la conexión a Internet
   • Comprueba si la API de currículums LaTeX es accesible

3. PDF no generado:

   • Verifica los permisos del directorio de currículums generados
   • Asegúrate de que el directorio exista y tenga permisos de escritura

4. Errores de creación de carpetas:

   • Verifica los permisos de escritura en el directorio de currículums generados
   • Comprueba que las rutas de carpetas no contengan caracteres no válidos

5. Problemas relacionados con rutas:

   • Las rutas de carpetas se sanean automáticamente por seguridad
   • Los caracteres no válidos se reemplazan con guiones bajos
   • Los intentos de recorrido de directorios (../) se bloquean automáticamente

Modo de depuración

Habilita el registro de depuración configurando la variable de entorno:

DEBUG=resume-generator node server.js

Desarrollo

Estructura del proyecto

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

Dependencias

• @modelcontextprotocol/sdk: SDK MCP para la implementación del servidor
• node-fetch: Cliente HTTP para solicitudes de API
• fs/promises: Operaciones del sistema de archivos para la gestión de carpetas

Funciones de seguridad

• Saneamiento de rutas: Previene ataques de recorrido de directorios
• Validación de entradas: Valida rutas de carpetas y nombres de archivo
• Limitación de alcance: Todas las operaciones se limitan al directorio de currículums generados
• Filtrado de caracteres: Elimina o reemplaza caracteres de sistema de archivos no válidos

Contribuciones

1. Haz un fork del repositorio
2. Crea una rama de características: git checkout -b feature-name
3. Realiza tus cambios y prueba a fondo
4. Envía una solicitud de extracción con una descripción clara

Créditos

Este proyecto está construido sobre varios proyectos y servicios de código abierto increíbles:

API de currículums LaTeX

• Servicio: latexresu.me - API profesional de generación de currículums LaTeX
• Créditos: Gracias al equipo de la API de currículums LaTeX por proporcionar el servicio backend que impulsa la generación de PDF

Plantillas LaTeX

Las hermosas plantillas de currículum están basadas en diseños de resumake.io y la comunidad LaTeX en general:

• Centro de Desarrollo Profesional de Rensselaer
• Byungjin Park - Plantilla de CV increíble
• Scott Clark - Diseños limpios y profesionales
• Debarghya Das - Plantillas de currículum modernas
• Xavier Danaux - Estilos clásicos de currículum LaTeX
• Ratul Saha - Diseños contemporáneos
• Daniil Belyakov - Plantillas minimalistas
• Frits Wenneker - Plantillas de CV profesionales

Pila tecnológica

• MCP (Model Context Protocol) - Anthropic para la especificación del protocolo
• Claude Desktop - Plataforma de integración para herramientas impulsadas por IA
• Node.js - Entorno de ejecución para la gestión de carpetas y operaciones de archivos
• LaTeX - Sistema de preparación de documentos para composición tipográfica de alta calidad

Licencia

MIT © Contribuyentes de Resume Generator

Soporte

• 🐛 Informes de errores: Issues de GitHub
• 💡 Solicitudes de funciones: Discusiones de GitHub
• Contacto: Usa los Issues de GitHub para soporte.

Registro de cambios

v2.0.0 - Actualización de gestión de carpetas

• ✨ NUEVO: Organización de carpetas personalizadas dentro del directorio de currículums generados
• ✨ NUEVO: Herramienta create_folder para crear estructuras de directorios organizadas
• ✨ NUEVO: Herramienta list_folders para explorar y gestionar colecciones de currículums
• ✨ NUEVO: generate_resume mejorado con el parámetro folderPath
• 🛡️ NUEVO: Saneamiento de rutas y funciones de seguridad
• 📊 NUEVO: Visualización de metadatos de archivos (tamaño, fecha) en los listados de directorios
• 🗂️ NUEVO: Creación automática de rutas de carpetas al generar currículums
• 📁 NUEVO: Soporte para estructuras de carpetas anidadas
• 🔍 NUEVO: Herramientas de navegación de directorios y organización de archivos

v1.0.0

• Lanzamiento inicial
• Soporte para 9 plantillas LaTeX mediante la API de currículums LaTeX
• Generación de currículums en lenguaje natural a través de Claude Desktop
• Implementación del servidor MCP con soporte de datos estructurados
• Salida PDF profesional con plantillas personalizables

---

Hecho con ❤️ para la comunidad de Claude Desktop y MCP