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 для получения ссылок.

Инструменты

Установка

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.

Требования

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