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.
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 |
| Informe completo. Toma una ruta de archivo de CV (PDF o DOCX) y devuelve hallazgos de linting por proveedor con gravedad ( |
| Linting de un solo proveedor. Toma una ruta + nombre del proveedor. Más rápido cuando al usuario solo le interesa un ATS. |
| 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-mcpConfiguració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.pdfy 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 | error | >15% de las líneas tienen un espacio de 5+ caracteres |
| Workday | warn | Las fechas usan el formato "Q3 2024" |
| Workday | error | Sin correo electrónico o teléfono en texto plano |
| Greenhouse | warn | Cualquier punto de código emoji detectado |
| Greenhouse | info | Glifos de viñetas no estándar |
| Greenhouse | warn | "Mi historia", "Lo más destacado", etc. |
| Lever | warn | Patrón "Página X de Y" detectado |
| Lever | error | Sin secciones de "Experiencia"/"Educación" |
| Taleo | warn | Las fechas ISO superan a las fechas Mes-Año |
| Taleo | error | <1 palabra por kB de tamaño de archivo |
| Taleo | info | Comillas tipográficas detectadas |
| iCIMS | error | >20% de las líneas con varias columnas |
| 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 test19 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 toolsanalyze_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
Scored across 3 tools
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.
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'.
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.
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
Related MCP Connectors
Public MCP server for discovering open jobs. Search, filter, and get application links.
Document-to-Markdown MCP server — convert PDF, Office and HTML into LLM-ready Markdown.
Document conversion MCP server: PDF to Markdown, image OCR, spreadsheet parsing.
Hosted MCP server: convert PDFs to clean, LLM-ready Markdown with tables, formulas and OCR.
Related MCP Servers
AlicenseBqualityCmaintenanceHosted 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.3313MIT- AlicenseBqualityDmaintenanceDeterministic 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.75MIT
- AlicenseNot gradedqualityDmaintenanceAn intelligent, zero-cost MCP server that securely parses local resumes and compares them against live job postings for ATS scoring, skill gap analysis, and interview prep.MIT
- AlicenseNot gradedqualityDmaintenanceMCP server for processing Markdown resumes into multiple formats (PDF, LinkedIn templates) with AI analysis and Claude integration.MIT