cv-mirror-mcp
cv-mirror-mcp
Сервер Model Context Protocol, который проверяет резюме на соответствие 5 реальным ATS-парсерам.
Что он делает
Предоставляет три инструмента MCP, чтобы любой AI-агент, совместимый с MCP (Claude Code, Cursor, Windsurf, Zed, OpenCode, Cline и др.), мог проанализировать резюме на предмет задокументированных особенностей:
Workday
Greenhouse
Lever
Taleo (Oracle)
iCIMS
Это 5 наиболее часто используемых корпоративных ATS-систем. Каждая из них парсит резюме немного по-разному. «Оценка ATS 0–100» усредняет эти различия до шума. Этот сервер показывает, что именно делает каждая из них — обработка колонок, удаление эмодзи, отбрасывание верхних и нижних колонтитулов, особенности форматов дат — в виде конкретных результатов линтинга с конкретными исправлениями.
Правила линтинга основаны на публичной документации вендоров. См. docs/vendor-sources.md для получения ссылок.
Related MCP server: decroche-mcp
Инструменты
Инструмент | Описание |
| Полный отчет. Принимает путь к файлу резюме (PDF или DOCX), возвращает результаты линтинга для каждого вендора с уровнем серьезности ( |
| Линтинг для одного вендора. Принимает путь + название вендора. Быстрее, если пользователя интересует только одна ATS. |
| Возвращает URL визуального веб-компаньона (cv-mirror-web.vercel.app) для пользователей, которые предпочитают просмотр парсера в браузере, а не сессию с агентом. |
Установка
npm (рекомендуется)
npm install -g cv-mirror-mcpКонфигурация клиента MCP
Добавьте в файл конфигурации вашего MCP-клиента:
Claude Code (~/.claude/mcp.json или .claude.json в проекте):
{
"mcpServers": {
"cv-mirror": {
"command": "npx",
"args": ["-y", "cv-mirror-mcp"]
}
}
}Cursor / Windsurf / Zed / Cline: тот же формат конфигурации (вставьте туда, где ваш клиент считывает mcpServers).
Перезапустите клиент. Три указанных выше инструмента зарегистрируются автоматически.
Использование
После установки просто спросите своего агента:
Просканируй мое резюме по адресу
~/Documents/resume.pdfи скажи мне, что с ним сделает каждая ATS.
Агент вызывает analyze_cv, движок линтинга запускается локально (без сети, без загрузки), и агент выводит структурированный результат:
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.
...Что именно проверяет линтинг
Это реальные эвристики, полученные из публичных документов ATS и статей поддержки вендоров. Полный список со ссылками находится в docs/vendor-sources.md.
Правило | Вендор | Серьезность | Триггер |
| Workday | error | >15% строк имеют разрыв в 5+ пробелов |
| Workday | warn | Даты используют формат "Q3 2024" |
| Workday | error | Нет email или телефона в обычном тексте |
| Greenhouse | warn | Обнаружен любой кодовый символ эмодзи |
| Greenhouse | info | Нестандартные глифы маркированных списков |
| Greenhouse | warn | "My Story", "Highlights Reel" и т.д. |
| Lever | warn | Обнаружен шаблон "Page X of Y" |
| Lever | error | Нет разделов "Experience"/"Education" |
| Taleo | warn | ISO-даты преобладают над датами в формате Месяц-Год |
| Taleo | error | <1 слова на КБ размера файла |
| Taleo | info | Обнаружены фигурные кавычки |
| iCIMS | error | >20% строк многоколоночные |
| iCIMS | warn | Найдено <2 стандартных заголовков |
Требования
Node.js >= 18
MCP-совместимый клиент (Claude Code, Cursor, Windsurf, Zed, Cline и др.)
Конфиденциальность
Сервер работает локально внутри процесса вашего агента. Нет эндпоинта для загрузки. Нет телеметрии. Байты вашего резюме никогда не покидают ваш компьютер.
Визуальный веб-компаньон на cv-mirror-web.vercel.app также полностью работает на стороне клиента — тот же движок, работает в браузере.
Тесты
git clone https://github.com/goofypluto999/cv-mirror-mcp.git
cd cv-mirror-mcp
npm install
npm test19 модульных тестов, охватывающих извлечение сигналов и срабатывание правил для каждого вендора.
Родственные проекты
CV Mirror (web) — визуальный просмотр парсера в режиме сравнения. Тот же движок линтинга. Перетащите PDF, чтобы увидеть наложение порядка чтения на реальный документ.
Vantage AI — как только ваше резюме проходит парсеры, следующая проблема — это отклик: адаптированное сопроводительное письмо, пробное интервью, анализ соответствия. Vantage берет на себя этот процесс. Платно (£5 стартовый пакет / 20 токенов, 10 бесплатных токенов при регистрации).
Участие в разработке
Pull-запросы приветствуются. Особенно интересны:
Больше симуляторов вендоров (BambooHR, SmartRecruiters, JazzHR, Recruitee и др.)
Обновленные правила, когда вендоры меняют поведение парсинга (откройте issue со ссылкой на источник)
Переводы вывода линтинга
Лицензия
MIT. Workday, Greenhouse, Lever, Taleo и iCIMS являются торговыми марками соответствующих владельцев. Этот проект не связан ни с одним из них; названия используются для описательной ссылки (добросовестное использование).
Создано 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.3312MIT- 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