Skip to main content
Glama
cv-mirror-mcp

cv-mirror-mcp

cv-mirror-mcp

5개의 실제 ATS 파서를 기준으로 이력서를 린트(lint)하는 모델 컨텍스트 프로토콜(MCP) 서버입니다.

License: MIT MCP Tests Node

기능

3개의 MCP 도구를 노출하여 MCP 호환 AI 에이전트(Claude Code, Cursor, Windsurf, Zed, OpenCode, Cline 등)가 다음 ATS의 문서화된 특성에 맞춰 이력서를 분석할 수 있도록 합니다:

  • Workday

  • Greenhouse

  • Lever

  • Taleo (Oracle)

  • iCIMS

이들은 가장 많이 사용되는 5가지 엔터프라이즈 ATS 시스템입니다. 각 시스템은 이력서를 조금씩 다르게 파싱합니다. "0–100 ATS 점수"는 이러한 차이를 평균 내어 노이즈로 만듭니다. 이 서버는 열 처리, 이모지 제거, 머리글/바닥글 삭제, 날짜 형식 특성 등 각 시스템이 실제로 수행하는 작업을 구체적인 린트 결과와 해결책으로 제시합니다.

린트 규칙은 공개된 벤더 문서를 기반으로 합니다. 출처는 docs/vendor-sources.md를 참조하세요.

Related MCP server: decroche-mcp

도구

도구

설명

analyze_cv

전체 보고서. 이력서 파일 경로(PDF 또는 DOCX)를 입력받아 벤더별 린트 결과(심각도 error / warn / info)와 해결책을 반환합니다.

lint_for_vendor

단일 벤더 린트. 경로와 벤더 이름을 입력받습니다. 사용자가 특정 ATS 하나만 신경 쓸 때 더 빠릅니다.

get_express_url

에이전트 세션 대신 브라우저에서 나란히 파서 뷰를 보길 원하는 사용자를 위해 시각적 웹 컴패니언(cv-mirror-web.vercel.app)의 URL을 반환합니다.

설치

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

일반 텍스트에 이메일이나 전화번호가 없음

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

파일 크기 kB당 단어 수 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 무료 토큰 제공).

기여

풀 리퀘스트를 환영합니다. 특히 다음 사항에 관심이 있습니다:

  • 더 많은 벤더 시뮬레이터 (BambooHR, SmartRecruiters, JazzHR, Recruitee 등)

  • 벤더의 파싱 동작 변경 시 업데이트된 규칙 (출처 링크와 함께 이슈 생성)

  • 린트 출력 번역

라이선스

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

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