Skip to main content
Glama
cv-mirror-mcp

cv-mirror-mcp

cv-mirror-mcp

Model Context Protocol-Server, der einen Lebenslauf anhand von 5 echten ATS-Parsern prüft.

License: MIT MCP Tests Node

Funktionsweise

Stellt drei MCP-Tools bereit, damit jeder MCP-kompatible KI-Agent (Claude Code, Cursor, Windsurf, Zed, OpenCode, Cline usw.) einen Lebenslauf anhand der dokumentierten Eigenheiten folgender Systeme analysieren kann:

  • Workday

  • Greenhouse

  • Lever

  • Taleo (Oracle)

  • iCIMS

Dies sind die 5 am häufigsten verwendeten Enterprise-ATS-Systeme. Jedes davon parst Lebensläufe leicht unterschiedlich. Ein "0–100 ATS-Score" mittelt diese Unterschiede zu Rauschen. Dieser Server zeigt auf, was jedes System tatsächlich tut – Spaltenbehandlung, Entfernen von Emojis, Ignorieren von Kopf- und Fußzeilen, Eigenheiten bei Datumsformaten – als konkrete Lint-Ergebnisse mit konkreten Korrekturvorschlägen.

Die Lint-Regeln basieren auf öffentlichen Herstellerdokumentationen. Siehe docs/vendor-sources.md für Quellenangaben.

Related MCP server: decroche-mcp

Tools

Tool

Beschreibung

analyze_cv

Vollständiger Bericht. Nimmt einen Dateipfad zum Lebenslauf (PDF oder DOCX) entgegen und gibt herstellerspezifische Lint-Ergebnisse mit Schweregrad (error / warn / info) und Korrekturen zurück.

lint_for_vendor

Lint für einen einzelnen Hersteller. Nimmt einen Pfad + Herstellernamen entgegen. Schneller, wenn der Benutzer nur an einem bestimmten ATS interessiert ist.

get_express_url

Gibt die URL der visuellen Web-Begleitanwendung (cv-mirror-web.vercel.app) für Benutzer zurück, die eine Side-by-Side-Parser-Ansicht im Browser einer Agenten-Sitzung vorziehen.

Installation

npm (empfohlen)

npm install -g cv-mirror-mcp

MCP-Client-Konfiguration

Fügen Sie dies zur Konfigurationsdatei Ihres MCP-Clients hinzu:

Claude Code (~/.claude/mcp.json oder .claude.json im Projekt):

{
  "mcpServers": {
    "cv-mirror": {
      "command": "npx",
      "args": ["-y", "cv-mirror-mcp"]
    }
  }
}

Cursor / Windsurf / Zed / Cline: gleiches Konfigurationsformat (einfügen, wo immer Ihr Client mcpServers liest).

Starten Sie den Client neu. Die drei oben genannten Tools werden automatisch registriert.

Verwendung

Nach der Installation fragen Sie einfach Ihren Agenten:

Scan my CV at ~/Documents/resume.pdf and tell me what each ATS would do to it.

Der Agent ruft analyze_cv auf, die Lint-Engine läuft lokal (kein Netzwerk, kein Upload), und der Agent zeigt die strukturierte Ausgabe an:

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

Was genau geprüft wird

Dies sind echte Heuristiken, die aus öffentlichen ATS-Dokumenten und Support-Artikeln der Hersteller abgeleitet wurden. Die vollständige Liste mit Quellenangaben befindet sich in docs/vendor-sources.md.

Regel

Hersteller

Schweregrad

Auslöser

WORKDAY_MULTI_COLUMN

Workday

error

>15% der Zeilen haben eine Lücke von 5+ Leerzeichen

WORKDAY_QUARTER_DATES

Workday

warn

Datumsangaben verwenden das Format "Q3 2024"

WORKDAY_CONTACT_MISSING

Workday

error

Keine E-Mail oder Telefonnummer im Klartext

GREENHOUSE_EMOJI

Greenhouse

warn

Beliebiger Emoji-Codepoint erkannt

GREENHOUSE_FANCY_BULLETS

Greenhouse

info

Nicht-standardisierte Aufzählungszeichen

GREENHOUSE_NONSTANDARD_HEADER

Greenhouse

warn

"My Story", "Highlights Reel" usw.

LEVER_HEADER_FOOTER

Lever

warn

"Seite X von Y"-Muster erkannt

LEVER_NO_STANDARD_HEADERS

Lever

error

Keine "Experience"/"Education"-Abschnitte

TALEO_ISO_DATES

Taleo

warn

ISO-Datumsangaben überwiegen Monat-Jahr-Datumsangaben

TALEO_LOW_TEXT_DENSITY

Taleo

error

<1 Wort pro kB Dateigröße

TALEO_SMART_QUOTES

Taleo

info

Geschwungene Anführungszeichen erkannt

ICIMS_MULTI_COLUMN

iCIMS

error

>20% der Zeilen mehrspaltig

ICIMS_FEW_HEADERS

iCIMS

warn

<2 Standard-Überschriften gefunden

Anforderungen

  • Node.js >= 18

  • Ein MCP-kompatibler Client (Claude Code, Cursor, Windsurf, Zed, Cline usw.)

Datenschutz

Der Server läuft lokal innerhalb des Prozesses Ihres Agenten. Kein Upload-Endpunkt. Keine Telemetrie. Ihre Lebenslauf-Daten verlassen niemals Ihren Rechner.

Die visuelle Web-Begleitanwendung unter cv-mirror-web.vercel.app ist ebenfalls vollständig clientseitig – dieselbe Engine, läuft im Browser.

Tests

git clone https://github.com/goofypluto999/cv-mirror-mcp.git
cd cv-mirror-mcp
npm install
npm test

19 Unit-Tests, die Signalerfassung und das Auslösen von Regeln pro Hersteller abdecken.

Schwesterprojekte

  • CV Mirror (web) — visuelle Side-by-Side-Parser-Ansicht. Dieselbe Lint-Engine. Ziehen Sie ein PDF per Drag-and-Drop hinein und sehen Sie das Overlay der Lesereihenfolge auf dem tatsächlichen Dokument.

  • Vantage AI — sobald Ihr Lebenslauf die Parser passiert hat, ist das nächste Problem die Bewerbung: maßgeschneidertes Anschreiben, simuliertes Vorstellungsgespräch, Eignungsanalyse. Vantage übernimmt diesen Ablauf. Kostenpflichtig (£5 Starter / 20 Token, 10 kostenlose Token bei der Anmeldung).

Mitwirken

Pull Requests sind willkommen. Besonders interessiert an:

  • Weitere Herstellersimulatoren (BambooHR, SmartRecruiters, JazzHR, Recruitee usw.)

  • Aktualisierte Regeln, wenn Hersteller ihr Parsing-Verhalten ändern (öffnen Sie ein Issue mit dem Quellenlink)

  • Übersetzungen der Lint-Ausgabe

Lizenz

MIT. Workday, Greenhouse, Lever, Taleo und iCIMS sind Marken ihrer jeweiligen Eigentümer. Dieses Projekt ist mit keinem von ihnen verbunden; die Namen werden zur beschreibenden Referenz verwendet (nominative fair use).

Erstellt von 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