ResumePilot MCP

Un servidor MCP Universal de Solicitudes de Empleo escalable para Claude Desktop.

Le das a Claude un currículum maestro. ResumePilot lo analiza, construye un perfil reutilizable, analiza descripciones de empleo contra él, calcula puntuaciones ATS/coincidencia específicas del puesto, genera currículums personalizados que nunca inventan información, rastrea cada solicitud en una base de datos local y produce un informe final en PDF con páginas de seguimiento por solicitud.

Fase 1 (esta versión) es una base completa, probada y totalmente local. Pegas una descripción de empleo y todo el flujo se ejecuta de principio a fin, sin necesidad de un sitio de empleo externo. La búsqueda global de empleo, la automatización de solicitudes y el seguimiento de correos electrónicos son fases posteriores que encajan en la misma arquitectura de adaptadores. Consulta docs/ARCHITECTURE.md.

Lo que no hará

• ❌ Nunca inventa habilidades, experiencia, educación, certificaciones o métricas.

• ❌ Nunca almacena contraseñas o OTPs de LinkedIn/Naukri u otros.

• ❌ Nunca elude CAPTCHA, 2FA, protección contra bots o autenticación.

• ❌ Nunca envía automáticamente a sitios web arbitrarios (la Fase 1 prepara; tú envías).

Si una habilidad requerida no se puede verificar a partir de tu material, ResumePilot informa "Habilidad requerida no verificada en el perfil del usuario." — no la añadirá.

Related MCP server: resume-tailor-mcp-server

Requisitos

• Node.js ≥ 18.18

• Claude Desktop (para uso de MCP)

Instalación y compilación

git clone <your-fork-url> resumepilot-mcp
cd resumepilot-mcp
npm install
npm run build
cp .env.example .env    # optional — sensible defaults otherwise

Pruébalo sin Claude (demo sin conexión)

Ejecuta todo el flujo a través de las mismas herramientas que Claude usa, en una carpeta temporal:

npm run demo

Verás puntuaciones ATS originales→optimizadas, un informe PDF generado y páginas de seguimiento HTML.

Ejecutar las pruebas

npm test

40 pruebas cubren el análisis, la puntuación, la garantía de "nunca inventar", la optimización, el seguimiento, los informes y el flujo de herramientas de extremo a extremo.

Descargar (extensión de Claude Desktop)

Obtén la extensión lista para instalar desde la página de Releases :

¿Solo quieres la extensión? Descarga resumepilot.mcpb, abre Claude Desktop → Configuración → Extensiones, arrastra el archivo, configura tu carpeta de datos y actívala.

Instalar en Claude Desktop

Dos opciones — guía completa en docs/INSTALL.md :

• Extensión de escritorio de un clic: npm run bundle produce resumepilot.mcpb; arrástrala a Claude Desktop → Configuración → Extensiones, configura tu carpeta de datos y actívala. (El paquete incluye un binario SQLite nativo, así que compílalo en tu propio sistema operativo — un comando — para macOS/Windows.)

• Configuración manual de MCP: compila desde el código fuente y añade una entrada mcpServers.

Conectar a Claude Desktop (configuración manual)

1. Compila: npm run build (produce dist/src/index.js).

2. Abre tu archivo de configuración de Claude Desktop:

   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

   • Windows: %APPDATA%\Claude\claude_desktop_config.json

3. Añade el servidor (consulta docs/claude_desktop_config.example.json), usando rutas absolutas:

   {
     "mcpServers": {
       "resumepilot": {
         "command": "node",
         "args": ["/ABSOLUTE/PATH/TO/resumepilot-mcp/dist/src/index.js"],
         "env": {
           "RESUMEPILOT_DATA_DIR": "/ABSOLUTE/PATH/TO/your-private-data",
           "ATS_TARGET_SCORE": "90"
         }
       }
     }
   }

4. Cierra y vuelve a abrir Claude Desktop por completo. Las herramientas de ResumePilot aparecen en el menú de herramientas (🔌).

Úsalo

Solo di:

“Inicia mi proceso de solicitud de empleo con ResumePilot.”

Claude entiende el flujo de trabajo y hará lo siguiente:

1. Pedir tu currículum maestro → upload_master_resume (dale la ruta del archivo).

2. Analizarlo y pedir solo la información faltante → analyze_master_resume → setup_user_profile.

3. Tomar una descripción de empleo que pegues → analyze_job (muestra ATS original + brechas).

4. Construir un currículum personalizado → optimize_resume_for_job (ATS original vs optimizado, PDF + DOCX).

5. Preparar la solicitud → generate_application_profile → prepare_application.

6. Registrarla → apply_to_job (Fase 1: tú envías; Claude la marca como APLICADA con tu confirmación).

7. Seguimiento → update_application_tracking / search_application_emails.

8. Producir el informe final → generate_application_report (PDF + páginas de seguimiento).

Ejemplos de indicaciones

• "Aquí está mi currículum: /Users/me/Documents/resume.pdf. Configura mi perfil."

• "Analiza este empleo contra mi currículum: <pega la descripción del empleo>"

• "Optimiza mi currículum para la solicitud 1 y muéstrame la puntuación ATS antes/después."

• "¿Qué cambió y qué no pudiste verificar?"

• "Genera mi informe de solicitud."

Configuración (.env)

Seguridad y privacidad

• Tus datos permanecen en tu máquina bajo RESUMEPILOT_DATA_DIR (ignorado por git).

• Nunca se almacenan contraseñas o OTPs de terceros; las integraciones futuras usan flujos oficiales de OAuth/sesión con tokens fuera de los registros.

• Los registros van solo a stderr y redactan valores que parecen secretos.

• Elimina tus datos en cualquier momento borrando el directorio de datos.

Estructura del proyecto

src/
├── index.ts, server.ts          # MCP stdio server + tool registration
├── context.ts                   # composition root
├── tools/                       # 17 MCP tools (thin, Zod-validated)
├── services/                    # parsing, scoring, optimization, tracking, reports
├── providers/                   # jobs / applications / email adapters (+ registries)
├── database/                    # SQLite schema + repository
├── models/                      # Zod schemas & types
└── utils/                       # config, logger, text/keyword processing, ids
tests/                           # vitest suite (40 tests)
docs/                            # ARCHITECTURE.md, Claude Desktop config
scripts/demo.ts                  # offline end-to-end demo

Hoja de ruta

Fase 2: adaptador de búsqueda genérico, grupo de trabajadores, deduplicación, clasificación, ≤1,000 empleos · Fase 3: integraciones de fuentes de empleo compatibles · Fase 4: adaptadores de solicitudes · Fase 5: seguimiento de Gmail (OAuth) · Fase 6: interfaz de seguimiento alojada + empaquetado.

Licencia

MIT — consulta LICENSE.