ATS Engine

ATS Engine MCP 服务

一个 MCP 服务，让 AI 助手（Claude、Cursor、VS Code Copilot 等）以申请人跟踪系统（ATS）的方式读取你自己的简历，并使用 @veriworkly/ats-engine 发布的确定性评分规则为其评分。

各客户端的设置方法、每个工具及其输入，以及提示词示例：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）中，使用 cmd /c 包装 npx：

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（单个项目）：

{
  "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	一条评分规则：类别、严重程度、检查内容、分值及修正方法。提供 region 时，会按照该国家的评分方式说明（例如，照片在美国值 6 分，在德国则不计分）。如果 ID 未知，则会列出有效 ID。
extract_text	path 或 text；可选的 region	按 ATS 读取顺序逐行返回文本，以及测得的版面信息（列、表格、隐藏文本）。适用于询问“为什么它会这样读取我的简历？”的情况。

每个工具都会向助手返回可读文本，并以结构化 JSON 的形式返回结果（structuredContent，详见各工具的 outputSchema）。

资源 rubric://default 是完整的评分规则 JSON。

输入。

• 简历文件：.pdf、.docx、.html、.txt、.md，或 .json 格式的 JSON Resume 或 ats-resume 文档。招聘信息：.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 号法案》和《欧盟 AI 法案》等法律所指的自动化就业决策工具，而本软件包并未满足这些法律对你规定的义务。请参阅预期用途。

评分衡量的是简历的解析和阅读效果，不代表对个人的评价。

从源代码安装

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