cv-mirror-mcp

Servidor del Protocolo de Contexto de Modelo (MCP) que analiza un CV frente a 5 parsers de ATS reales.

Qué hace

Expone tres herramientas MCP para que cualquier agente de IA compatible con MCP (Claude Code, Cursor, Windsurf, Zed, OpenCode, Cline, etc.) pueda analizar un CV frente a las peculiaridades documentadas de:

• Workday

• Greenhouse

• Lever

• Taleo (Oracle)

• iCIMS

Estos son los 5 sistemas ATS empresariales más utilizados. Cada uno analiza los CV de forma ligeramente distinta. Una "puntuación ATS de 0 a 100" promedia esas diferencias convirtiéndolas en ruido. Este servidor muestra lo que realmente hace cada uno (manejo de columnas, eliminación de emojis, descarte de encabezados y pies de página, peculiaridades de formato de fecha) como hallazgos de linting concretos con soluciones concretas.

Las reglas de linting se derivan de la documentación pública de los proveedores. Consulta docs/vendor-sources.md para ver las citas.

Herramientas

Instalación

npm (recomendado)

npm install -g cv-mirror-mcp

Configuración del cliente MCP

Añade esto al archivo de configuración de tu cliente MCP:

Claude Code (~/.claude/mcp.json o .claude.json en el proyecto):

{
  "mcpServers": {
    "cv-mirror": {
      "command": "npx",
      "args": ["-y", "cv-mirror-mcp"]
    }
  }
}

Cursor / Windsurf / Zed / Cline: mismo formato de configuración (pega donde tu cliente lea mcpServers).

Reinicia el cliente. Las tres herramientas anteriores se autorregistran.

Uso

Una vez instalado, simplemente pregúntale a tu agente:

Escanea mi CV en ~/Documents/resume.pdf y dime qué haría cada ATS con él.

El agente llama a analyze_cv, el motor de linting se ejecuta localmente (sin red, sin subidas) y el agente muestra la salida estructurada:

CV Mirror — multi-vendor ATS lint report
Source: /Users/jane/Documents/resume.pdf
Format: pdf
Pages: 2
Words: 542

[ERROR] Workday
  - ERROR WORKDAY_MULTI_COLUMN: 35% of lines look multi-column. Workday's parser
    reads left-to-right and interleaves both columns into one stream.
    Fix: Convert to single-column layout. Move sidebars (Skills, Tools, Languages)
    above or below the main content.

[OK] Greenhouse
  No issues detected by the simulated parser.

[WARN] Lever
  - WARN LEVER_HEADER_FOOTER: Header/footer-like text detected ("Page 1 of 2").
    Lever historically drops content placed in PDF headers/footers.
    Fix: Remove headers and footers. Page numbers are not needed on a CV.
...

Qué comprueba realmente el linting

Estas son heurísticas reales derivadas de documentos públicos de ATS y artículos de soporte de proveedores. La lista completa con citas se encuentra en docs/vendor-sources.md.

Requisitos

• Node.js >= 18

• Un cliente compatible con MCP (Claude Code, Cursor, Windsurf, Zed, Cline, etc.)

Privacidad

El servidor se ejecuta localmente dentro del proceso de tu agente. No hay punto final de carga. No hay telemetría. Los bytes de tu CV nunca salen de tu máquina.

El compañero web visual en cv-mirror-web.vercel.app también es totalmente del lado del cliente: mismo motor, se ejecuta en el navegador.

Pruebas

git clone https://github.com/goofypluto999/cv-mirror-mcp.git
cd cv-mirror-mcp
npm install
npm test

19 pruebas unitarias que cubren la extracción de señales y la activación de reglas por proveedor.

Proyectos hermanos

• CV Mirror (web) — vista de parser visual comparativa. Mismo motor de linting. Arrastra y suelta un PDF, mira la superposición del orden de lectura en el documento real.

• Vantage AI — una vez que tu CV pasa los parsers, el siguiente problema es la solicitud: carta de presentación personalizada, entrevista simulada, análisis de ajuste. Vantage maneja ese flujo. De pago (£5 inicial / 20 tokens, 10 tokens gratis al registrarse).

Contribución

Las solicitudes de extracción (pull requests) son bienvenidas. Especialmente interesado en:

• Más simuladores de proveedores (BambooHR, SmartRecruiters, JazzHR, Recruitee, etc.)

• Reglas actualizadas cuando los proveedores cambian su comportamiento de análisis (abre un issue con el enlace a la fuente)

• Traducciones de la salida del linting

Licencia

MIT. Workday, Greenhouse, Lever, Taleo e iCIMS son marcas comerciales de sus respectivos propietarios. Este proyecto no está afiliado a ninguno de ellos; los nombres se utilizan como referencia descriptiva (uso legítimo nominativo).

Creado por Vantage Labs.