ATS Engine

ATS Engine MCP サーバー

AI アシスタント（Claude、Cursor、VS Code Copilot など）が、応募者追跡システム（ATS）と同じ方法であなた自身の履歴書を読み取り、@veriworkly/ats-engine が公開している決定論的な評価基準で採点できる MCP サーバーです。

各クライアントのセットアップ方法、すべてのツールとその入力、プロンプトの例については、docs.veriworkly.com/ats-engine/tools/mcp をご覧ください。

アシスタントには、「~/Documents/cv.pdf の履歴書をチェックして」「この求人情報との適合度はどのくらい？」「日付のチェックに失敗した理由は？」「ATS が私の履歴書をどう読み取るか見せて」などと尋ねられます。

スコアはモデルではなく、評価基準（RUBRIC.md）に基づいて算出されます。同じファイルには常に同じスコアが付与されます。アシスタントが結果を説明し、失敗した項目の修正をサポートします。

インストール

Node.js 22.12 以降が必要です。以下のすべてのクライアントで、npx -y @veriworkly/ats-engine-mcp を使ってサーバーを実行します。

Claude Code

claude mcp add ats-engine -- npx -y @veriworkly/ats-engine-mcp

ネイティブの Windows（WSL ではない環境）では、npx を cmd /c でラップします。

claude mcp add ats-engine -- cmd /c npx -y @veriworkly/ats-engine-mcp

Claude Desktop

「Settings」→「Developer」→「Edit Config」を開き、claude_desktop_config.json にサーバーを追加して、Claude Desktop を再起動します。

{
  "mcpServers": {
    "ats-engine": {
      "command": "npx",
      "args": ["-y", "@veriworkly/ats-engine-mcp"]
    }
  }
}

Cursor

~/.cursor/mcp.json（すべてのプロジェクト）または .cursor/mcp.json（1 つのプロジェクト）に追加します。

{
  "mcpServers": {
    "ats-engine": {
      "command": "npx",
      "args": ["-y", "@veriworkly/ats-engine-mcp"]
    }
  }
}

VS Code

ワークスペースの .vscode/mcp.json に追加するか、コマンドパレットから MCP: Add Server を実行します。

{
  "servers": {
    "ats-engine": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@veriworkly/ats-engine-mcp"]
    }
  }
}

ツール

ツール	入力	戻り値
check_resume	path または text。任意で job_path または job_text、region、target_ats	準備度スコア（0～100）、判定、カテゴリ別スコア（文章スタイルを含む）、失敗したすべてのチェックとその根拠および修正方法、ATS が保存するフィールド（氏名、連絡先、職歴、学歴、スキル。構造化された parsed には、認定資格と CEFR レベル付きの会話言語も含まれます）。求人情報を指定した場合は、求人とのマッチ度、要件、キーワードも含まれます。続いて、採点対象ではない advice が返されます。
match_job	path または text。job_path または job_text（必須）。任意で region	求人とのマッチ度スコア、各要件の判定（満たしている／一部満たしている／不足／検証不能）と根拠、さらに不足しているキーワード、ハードスキル、ソフトスキル（ソフトスキルの重みは低めです）。
explain_rule	rule_id。任意で region	ルーブリックのルール1件：カテゴリ、重大度、チェック内容、ポイント、修正方法。region を指定すると、その国における評価方法が示されます（写真は米国では6ポイント相当ですが、ドイツでは採点対象になりません）。不明な ID を指定すると、有効な ID の一覧が表示されます。
extract_text	path または text。任意で region	ATS が読み取る順序で、行ごとに並べたテキストと、レイアウトの測定結果（列、表、非表示テキスト）。「履歴書がこのように読み取られたのはなぜか」を調べる場合に使います。

すべてのツールは、アシスタントが読み取れるテキストと、構造化 JSON の結果（structuredContent。各ツールの outputSchema で説明されています）を返します。

リソース rubric://default には、ルーブリック全体が JSON 形式で含まれています。

入力。

• 履歴書ファイル：.pdf、.docx、.html、.txt、.md、または JSON Resume 形式か ats-resume 形式の .json ファイルです。求人情報は .txt、.md、.pdf、.docx、または保存済みの .html ページに対応しています。job_path にこれ以外の種類を指定すると拒否されます。求人情報の文面は回答に含まれるためです。
• 絶対パスを指定してください。~/ はホームフォルダーとして扱われ、それ以外の相対パスはサーバーの起動時のフォルダーを基準に扱われます。
• 貼り付けた text と job_text は最大 200 000 文字です。貼り付けた求人情報も、job_path から読み込んだ求人情報も、最初の 20 000 文字を対象にスコアを算出します。それを超える場合は切り詰められ、check_resume の parsingWarnings でその旨が示されます。
• 20 MB を超えるファイルは拒否されます。フォルダー、パイプ、デバイス、ネットワークパス（\\host\share\…。Windows では //host/share/… も含む）も拒否されます。テキストレイヤーのない PDF も拒否されます。ATS もスキャン画像は読み取れません。
• language（check_resume、match_job）には en、de、fr、hi、es、pt を指定できます。en は英語のみを読み取ります。 指定しない場合、履歴書と求人情報から言語が検出されます。この言語は両方に適用されるため、履歴書が誤った言語で読み取られた場合にのみ指定してください。ドイツ語の求人情報に対して en を指定すると、求人情報も英語として読み取られます。
• region には US、GB、DE、FR、IN、ES、BR、PT、MX、AR、CO、CL を指定できます。指定しない場合、履歴書から地域が推定されます。
• target_ats は greenhouse、lever、taleo のいずれかです。ベンダーが公開している情報を追加し、それぞれの注記にベンダーのページへのリンクを付けます。スコアは変更されません。

アドバイス。 check_resume の最後には、スコアの対象にならない advice の一覧が表示されます。ファイル（貼り付けたテキストではない場合）については、ファイル名（Resume_final_v3 (2).pdf は下書きと判断されます。Firstname-Lastname-Resume.pdf のような名前が推奨されます）、2 MB を超えるサイズ、パスワード、Word 文書に残された変更履歴やコメントを確認します。米国向けの履歴書では、年齢差別につながる可能性のある情報も確認します。target_ats を指定すると、ベンダーの注記も追加されます。

プライバシー

サーバーはお使いのコンピューター上で stdio を介して動作します。ネットワークリクエストを送信せず、AI モデルも呼び出しません。リクエストで指定したファイルのみを読み取ります。PDF、DOCX、HTML ファイルは別プロセスで処理され、そのプロセスは 60 秒後、またはリクエストがキャンセルされたときに停止します。処理はお使いのコンピューターの CPU コア数を上限に並行して実行されます。お使いのコンピューターから外部に送信されるのは、アシスタントがモデルプロバイダーに送信する情報のみです。これには、アシスタントが読み取るツールの結果（履歴書のテキストを含みます）が含まれます。

想定される用途

重要

これは、候補者が自分の履歴書を確認するためのツールです。他の人の選考、順位付け、または不採用の判断には使用しないでください。そのように使用すると、ニューヨーク市ローカル法第144号や EU AI Act などの法律において、自動雇用判断ツールに該当する可能性があります。その場合に課される義務を、このパッケージは満たしていません。詳しくは想定される用途をご覧ください。

スコアは、履歴書がどの程度正しく解析され、読み取られるかを示すものです。人物については何も示しません。

ソースから

git clone https://github.com/VeriWorkly/ats-engine.git
cd ats-engine
npm ci
npm run build
claude mcp add ats-engine -- node "$PWD/packages/mcp/dist/index.js"

ライセンス

MIT