cv-mirror-mcp

模型上下文协议 (MCP) 服务器，用于根据 5 种真实 ATS 解析器对简历进行 lint 检查。

功能

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

• Workday

• Greenhouse

• Lever

• Taleo (Oracle)

• iCIMS

这些是使用最广泛的 5 种企业级 ATS 系统。每种系统解析简历的方式略有不同。“0-100 ATS 分数”将这些差异平均化为噪音。此服务器将每种系统实际的操作方式（列处理、表情符号剥离、页眉页脚丢弃、日期格式怪癖）作为具体的 lint 发现结果和修复建议呈现出来。

lint 规则源自供应商的公开文档。引用请参阅 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 的位置）。

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

使用方法

安装完成后，只需询问您的代理：

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

代理调用 analyze_cv，lint 引擎在本地运行（无网络，无上传），代理呈现结构化输出：

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。

要求

• 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) — 可视化并排解析视图。相同的 lint 引擎。拖放 PDF，在实际文档上查看阅读顺序叠加层。

• Vantage AI — 一旦您的简历通过了解析器，下一个问题就是申请：定制求职信、模拟面试、匹配度分析。Vantage 处理该流程。付费（£5 入门 / 20 个代币，注册赠送 10 个免费代币）。

贡献

欢迎提交 Pull Request。特别感兴趣的是：

• 更多的供应商模拟器 (BambooHR, SmartRecruiters, JazzHR, Recruitee 等)

• 当供应商更改其解析行为时更新规则（请附带来源链接提交 issue）

• lint 输出的翻译

许可

MIT。Workday、Greenhouse、Lever、Taleo 和 iCIMS 是其各自所有者的商标。本项目与他们中的任何一个均无关联；名称仅用于描述性参考（提名合理使用）。

由 Vantage Labs 构建。