Skip to main content
Glama
cv-mirror-mcp

cv-mirror-mcp

cv-mirror-mcp

5つの主要なATSパーサーに対して履歴書をリント(検証)するModel Context Protocolサーバー。

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

ビジュアルWebコンパニオン (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 を読み取る場所に貼り付けてください)。

クライアントを再起動すると、上記の3つのツールが自動的に登録されます。

使用方法

インストール後、エージェントに次のように尋ねるだけです:

~/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

ファイルサイズ1kBあたり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 のビジュアルWebコンパニオンも完全にクライアントサイドで動作し、同じエンジンがブラウザ内で実行されます。

テスト

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など)

  • ベンダーの解析動作が変更された際のルールの更新(ソースリンクを添えて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).

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