Skip to main content
Glama
goofypluto999

cv-mirror-mcp

cv-mirror-mcp

Сервер Model Context Protocol, который проверяет резюме на соответствие 5 реальным ATS-парсерам.

License: MIT MCP Tests Node

Что он делает

Предоставляет три инструмента 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

Инструменты

Инструмент

Описание

analyze_cv

Полный отчет. Принимает путь к файлу резюме (PDF или DOCX), возвращает результаты линтинга для каждого вендора с уровнем серьезности (error / warn / info) и исправлениями.

lint_for_vendor

Линтинг для одного вендора. Принимает путь + название вендора. Быстрее, если пользователя интересует только одна ATS.

get_express_url

Возвращает 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_MULTI_COLUMN

Workday

error

>15% строк имеют разрыв в 5+ пробелов

WORKDAY_QUARTER_DATES

Workday

warn

Даты используют формат "Q3 2024"

WORKDAY_CONTACT_MISSING

Workday

error

Нет email или телефона в обычном тексте

GREENHOUSE_EMOJI

Greenhouse

warn

Обнаружен любой кодовый символ эмодзи

GREENHOUSE_FANCY_BULLETS

Greenhouse

info

Нестандартные глифы маркированных списков

GREENHOUSE_NONSTANDARD_HEADER

Greenhouse

warn

"My Story", "Highlights Reel" и т.д.

LEVER_HEADER_FOOTER

Lever

warn

Обнаружен шаблон "Page X of Y"

LEVER_NO_STANDARD_HEADERS

Lever

error

Нет разделов "Experience"/"Education"

TALEO_ISO_DATES

Taleo

warn

ISO-даты преобладают над датами в формате Месяц-Год

TALEO_LOW_TEXT_DENSITY

Taleo

error

<1 слова на КБ размера файла

TALEO_SMART_QUOTES

Taleo

info

Обнаружены фигурные кавычки

ICIMS_MULTI_COLUMN

iCIMS

error

>20% строк многоколоночные

ICIMS_FEW_HEADERS

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 test

19 модульных тестов, охватывающих извлечение сигналов и срабатывание правил для каждого вендора.

Родственные проекты

  • 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 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).

ParametersJSON Schema
NameRequiredDescriptionDefault
pathYesAbsolute path to the CV file (PDF or DOCX).

TDQS

A4.2/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations, so description carries full burden. It discloses tool reads PDF/DOCX, runs against 5 parsers, and returns findings. Does not mention file size limits, processing duration, or if file is uploaded elsewhere, but is largely transparent about its operation.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Two focused sentences: first defines action and output, second provides usage examples. No unnecessary words. Excellent front-loading of purpose.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Despite no output schema, description explains return types (per-vendor lint findings, risk score, fixes). Mentions supported file types. Could add error handling details (e.g., missing file), but otherwise complete for a single-parameter tool.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Input schema has 100% coverage with description for the single 'path' parameter. The description does not add further details beyond schema, but schema itself is sufficient. Baseline 3 applies.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description explicitly states the tool analyzes CVs against 5 ATS parsers, returning per-vendor lint findings, risk score, and fixes. It clearly distinguishes from siblings by covering multiple vendors (vs. lint_for_vendor which likely targets one).

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Description provides explicit user query triggers ('is my CV ATS-friendly', 'will my resume pass [vendor]', 'why am I not getting interviews') and mentions file path requirement. Lacks explicit when-not-to-use or mention of sibling alternatives, but context is clear.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

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.

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

TDQS

A4.2/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations provided, so description carries full burden. States it returns a URL, implying read-only, but does not explicitly declare non-destructive behavior or other constraints.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Two sentences, no unnecessary words, front-loaded with purpose. Highly efficient.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Adequate for a zero-parameter, no-output-schema tool. Explains function and usage context. Minor gap: doesn't explicitly state no input needed, but schema implies it.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

No parameters (schema coverage 100%), baseline 4. Description adds meaning by explaining the purpose of the URL beyond the empty schema.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

Clear verb+resource: 'Returns the URL' for a specific visual tool (CV Mirror). Distinguishes from siblings (analyze_cv, lint_for_vendor) by offering a different capability.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

States when it's useful (visual reading-order overlay, avoiding file path sharing). Does not explicitly exclude alternative uses but context is clear.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

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.

ParametersJSON Schema
NameRequiredDescriptionDefault
pathYesAbsolute path to the CV file (PDF or DOCX).
vendorYesATS vendor to simulate.

TDQS

A3.6/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description carries full burden. It does not explain whether the tool is read-only, what side effects exist, or what the output format is. The term 'lint' implies analysis but lacks detail.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Two sentences, front-loaded with the core action and constraint. Each sentence adds value: one states the purpose and allowed vendors, the other gives usage examples. No wasted words.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Despite its simplicity, the tool has no output schema and the description does not explain what the lint result looks like (e.g., a score, a list of issues). The user cannot infer the return format without additional context.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Input schema has 100% coverage with clear descriptions. The description adds context for the vendor enum by specifying use cases, but adds no extra meaning for the path parameter beyond its schema description.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description states 'Run lint for ONE specific ATS vendor only', with a clear verb and resource. It lists the allowed vendors and uses examples to distinguish from siblings like analyze_cv, making the purpose unambiguous.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Explicitly provides when-to-use examples ('when the user asks something vendor-specific like...'). Does not explicitly state when not to use or name an alternative tool, though the sibling names imply a general CV analysis tool.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Tool Schema Changelog

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

  1. 3 tool updatesv0.1.0
    • First observedanalyze_cv
    • First observedget_express_url
    • First observedlint_for_vendor

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
ResponsivenessUnresponsive

Related MCP Connectors

Related MCP Servers

  • A
    license
    B
    quality
    B
    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
    316
    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