CV Mirror MCP — Multi-vendor ATS Resume Linter

cv-mirror-mcp

可对照 5 种真实 ATS 解析器检查简历的 Model Context Protocol 服务。

功能

提供三个 MCP 工具，让任何兼容 MCP 的 AI Agent（Claude Code、Cursor、Windsurf、Zed、OpenCode、Cline 等）都能根据以下系统已知的解析特性分析简历：

• Workday
• Greenhouse
• Lever
• Taleo (Oracle)
• iCIMS

这 5 种系统是使用最广泛的企业 ATS。每种系统解析简历的方式都略有不同。“0–100 ATS 评分”会把这些差异平均成噪声。本服务会将每种系统的实际处理方式——列处理、表情符号剥离、页眉页脚丢弃、日期格式特性等——作为具体的 lint 发现和修复建议呈现出来。

lint 规则源自供应商公开文档。引用来源请参阅 docs/vendor-sources.md。

工具

工具	描述
analyze_cv	完整报告。接收简历文件路径（PDF 或 DOCX），返回各供应商的 lint 发现、严重级别（error / warn / info）及修复建议。
lint_for_vendor	单一供应商 lint。接收路径和供应商名称。适合只关心某一种 ATS 的用户，速度更快。
get_express_url	返回可视化网页配套工具的 URL（cv-mirror-web.vercel.app），供希望在浏览器中并排查看解析结果、而非使用 Agent 会话的用户使用。

安装

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 的位置）。

重启客户端。上述三个工具将自动注册。

用法

安装完成后，只需向你的 Agent 提问：

扫描我的 ~/Documents/resume.pdf 简历，并告诉我各个 ATS 会如何处理它。

Agent 会调用 analyze_cv，lint 引擎会在本地运行（不联网、不上传），然后 Agent 会展示结构化输出：

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

lint 实际检查的内容

这些是真实的启发式规则，源自公开的 ATS 文档和供应商支持文章。包含完整列表和引用的文档位于 docs/vendor-sources.md。

规则	供应商	严重程度	触发条件
WORKDAY_MULTI_COLUMN	Workday	错误	超过 15% 的行存在至少 5 个空格的间隔
WORKDAY_QUARTER_DATES	Workday	警告	日期采用“Q3 2024”格式
WORKDAY_CONTACT_MISSING	Workday	错误	纯文本中没有电子邮件或电话号码
GREENHOUSE_EMOJI	Greenhouse	警告	检测到任意 emoji 码位
GREENHOUSE_FANCY_BULLETS	Greenhouse	信息	使用了非标准项目符号
GREENHOUSE_NONSTANDARD_HEADER	Greenhouse	警告	出现“My Story”“Highlights Reel”等标题
LEVER_HEADER_FOOTER	Lever	警告	检测到“Page X of Y”模式
LEVER_NO_STANDARD_HEADERS	Lever	错误	没有“Experience”/“Education”版块
TALEO_ISO_DATES	Taleo	警告	ISO 日期数量多于“月份-年份”日期
TALEO_LOW_TEXT_DENSITY	Taleo	错误	每 kB 文件大小少于 1 个词
TALEO_SMART_QUOTES	Taleo	信息	检测到弯引号
ICIMS_MULTI_COLUMN	iCIMS	错误	超过 20% 的行采用多栏布局
ICIMS_FEW_HEADERS	iCIMS	警告	找到的标准标题少于 2 个

要求

• Node.js >= 18
• 兼容 MCP 的客户端（Claude Code、Cursor、Windsurf、Zed、Cline 等）

隐私

服务在你的 Agent 进程内本地运行。没有上传端点，也没有遥测。你的简历数据不会离开你的设备。

可视化网页配套工具 cv-mirror-web.vercel.app 也完全在客户端运行——使用相同的引擎，在浏览器中运行。

测试

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

19 个单元测试，覆盖信号提取和各供应商规则的触发情况。

如何与 Claude（及其他 AI Agent）搭配使用

cv-mirror-mcp 向任何兼容 MCP 的 Agent 提供三个工具。最常见的工作流如下：

1. 安装服务：npm install -g cv-mirror-mcp
2. 将其添加到 MCP 客户端配置中（Claude Desktop、Cursor、Windsurf、Zed——参见上方的 安装）。
3. 在 Agent 会话中提问：“在 /path/to/cv.pdf 上运行 cv-mirror，并告诉我 Workday 和 Greenhouse 会在哪些方面出错。”
4. Agent 调用 analyze_cv，获取按供应商分类的 lint 结果，其中包含严重程度和具体修复建议，然后展示给你。

简历整理完善后，你通常还需要准备申请的其他内容——公司调研、定制求职信、匹配度评分和模拟面试。Vantage 是一款付费工具，可处理这一整套流程（由同一团队打造，5 英镑入门包，注册即可获得 10 个免费令牌，试用无需银行卡）。

推荐的端到端工作流：

1. 通过 Agent 运行 cv-mirror-mcp → 修复简历中的解析问题。
2. 使用同一份简历以及具体的职位 URL 运行 Vantage → 大约 90 秒即可获得完整的求职准备包。

相关项目

• CV Mirror（网页） — 可视化并排解析视图。使用与此 MCP 服务相同的 lint 引擎。拖放 PDF，即可查看实际文档上的阅读顺序叠加层。免费、无需注册，完全在客户端运行。
• Vantage — 简历通过解析器检查后，接下来要处理的就是实际申请：公司情报、定制求职信（4 种语气）、AI 评分的模拟面试、简历与职位匹配度评分，以及 5 分钟陈述提纲。Vantage 可在每次申请约 90 秒内完成这一整套流程。5 英镑入门包 / 20 个令牌（永不过期），注册即可获得 10 个免费令牌。由同一团队打造。

贡献

欢迎提交拉取请求。我们尤其期待：

• 更多厂商模拟器（BambooHR、SmartRecruiters、JazzHR、Recruitee 等）
• 厂商更改解析行为时更新规则（请附上源链接并提交 issue）
• lint 输出的翻译

许可证

MIT。Workday、Greenhouse、Lever、Taleo 和 iCIMS 是其各自所有者的商标。本项目与这些公司均无关联；使用这些名称仅作描述性引用（指称性合理使用）。

由 Vantage Labs 构建。