cv-mirror-mcp

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

機能

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 を参照してください。

ツール

インストール

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 にあります。

要件

• 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 によって構築されました。