Skip to main content
Glama
cv-mirror-mcp

cv-mirror-mcp

cv-mirror-mcp

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

License: MIT MCP Tests Node

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.

Related MCP server: decroche-mcp

Herramientas

Herramienta

Descripción

analyze_cv

Informe completo. Toma una ruta de archivo de CV (PDF o DOCX) y devuelve hallazgos de linting por proveedor con gravedad (error / warn / info) y soluciones.

lint_for_vendor

Linting de un solo proveedor. Toma una ruta + nombre del proveedor. Más rápido cuando al usuario solo le interesa un ATS.

get_express_url

Devuelve la URL del compañero web visual (cv-mirror-web.vercel.app) para usuarios que prefieren una vista de parser comparativa en su navegador en lugar de una sesión de agente.

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.

Regla

Proveedor

Gravedad

Disparador

WORKDAY_MULTI_COLUMN

Workday

error

>15% de las líneas tienen un espacio de 5+ caracteres

WORKDAY_QUARTER_DATES

Workday

warn

Las fechas usan el formato "Q3 2024"

WORKDAY_CONTACT_MISSING

Workday

error

Sin correo electrónico o teléfono en texto plano

GREENHOUSE_EMOJI

Greenhouse

warn

Cualquier punto de código emoji detectado

GREENHOUSE_FANCY_BULLETS

Greenhouse

info

Glifos de viñetas no estándar

GREENHOUSE_NONSTANDARD_HEADER

Greenhouse

warn

"Mi historia", "Lo más destacado", etc.

LEVER_HEADER_FOOTER

Lever

warn

Patrón "Página X de Y" detectado

LEVER_NO_STANDARD_HEADERS

Lever

error

Sin secciones de "Experiencia"/"Educación"

TALEO_ISO_DATES

Taleo

warn

Las fechas ISO superan a las fechas Mes-Año

TALEO_LOW_TEXT_DENSITY

Taleo

error

<1 palabra por kB de tamaño de archivo

TALEO_SMART_QUOTES

Taleo

info

Comillas tipográficas detectadas

ICIMS_MULTI_COLUMN

iCIMS

error

>20% de las líneas con varias columnas

ICIMS_FEW_HEADERS

iCIMS

warn

<2 encabezados estándar encontrados

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.

Available Tools

3 tools
analyze_cvA

Analyse a CV (PDF or DOCX) against 5 real ATS parsers (Workday, Greenhouse, Lever, Taleo, iCIMS). Returns per-vendor lint findings, parse risk score, and concrete fixes. Use when the user asks 'is my CV ATS-friendly', 'will my resume pass [vendor]', or 'why am I not getting interviews' (with a file path).

Inputs: path (required).

get_express_urlA

Returns the URL for the visual web companion tool (CV Mirror) where the user can drag-drop a CV and see the side-by-side parser view in their browser. Useful when the user wants the visual reading-order overlay or doesn't want to share a file path.

Inputs: no named parameters.

lint_for_vendorA

Run lint for ONE specific ATS vendor only. Use when the user asks something vendor-specific like 'will my CV pass Workday' or 'what would Greenhouse strip from this'. Vendor must be one of: workday, greenhouse, lever, taleo, icims.

Inputs: path (required), vendor (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.8/5.0

    Scored across 3 tools

    Disambiguation4/5

    The tools have distinct purposes: analyze_cv for all vendors, lint_for_vendor for a single vendor, and get_express_url for a visual URL. However, analyze_cv and lint_for_vendor both analyze CVs, which could cause minor confusion if descriptions are not read carefully.

    Naming Consistency3/5

    Tool names follow a verb_noun pattern but with inconsistency: 'analyze_cv' and 'get_express_url' are direct, while 'lint_for_vendor' uses a preposition. The verb 'lint' is less standard than 'analyze'.

    Tool Count4/5

    With 3 tools, the set is small but well-scoped for the domain of CV ATS analysis. It covers the essential operations without being overly sparse.

    Completeness4/5

    The tool set covers comprehensive analysis, vendor-specific linting, and a visual companion tool. Minor gaps like listing vendors or handling multiple files are absent but not critical for the core functionality.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      C
      maintenance
      Hosted MCP server for job search (3M+ jobs from employer career pages and ATS feeds like Lever/Greenhouse), PDF resume generation with multiple templates, AI resume tailoring per job description, cover letters, and career advice. Free hosted endpoint, no API key required.
      3
      313
      MIT
    • A
      license
      B
      quality
      D
      maintenance
      Deterministic MCP server for job-landing pipeline that parses CVs into validated JSON Resume, detects sections, scores parse confidence, and exposes FR/US market profiles to help beat ATS and LLM screeners honestly.
      75
      MIT