ResumePilot MCP

一个可扩展的通用求职申请 MCP 服务器，适用于 Claude Desktop。

你给 Claude 一份主简历。ResumePilot 随后解析它，构建一个可复用的个人资料，针对它分析职位描述，计算针对特定职位的 ATS/匹配分数，生成绝不虚构信息的定制简历，在本地数据库中跟踪每一次申请，并生成带有每个申请跟踪页面的最终 PDF 报告。

第一阶段（本版本） 是一个完整、经过测试、完全本地的基座。你粘贴一份职位描述，整个流水线即可端到端运行——无需外部求职网站。全球职位搜索、申请自动化和邮件跟踪是后续阶段，它们将接入相同的适配器架构。参见 docs/ARCHITECTURE.md。

它不会做什么

• ❌ 绝不虚构技能、经验、教育背景、证书或指标。

• ❌ 绝不存储 LinkedIn/Naukri/其他密码或 OTP。

• ❌ 绝不绕过 CAPTCHA、2FA、机器人防护或身份验证。

• ❌ 绝不自动提交到任意网站（第一阶段做准备；由你提交）。

如果某项必需技能无法从你的材料中验证，ResumePilot 会报告 "Required skill not verified from the user's profile."（必需技能无法从用户资料中验证）——它不会添加该技能。

Related MCP server: resume-tailor-mcp-server

环境要求

• Node.js ≥ 18.18

• Claude Desktop（用于 MCP 使用）

安装与构建

git clone <your-fork-url> resumepilot-mcp
cd resumepilot-mcp
npm install
npm run build
cp .env.example .env    # optional — sensible defaults otherwise

无需 Claude 试用（离线演示）

在临时文件夹中，通过 Claude 调用的相同工具运行完整流水线：

npm run demo

你将看到原始→优化后的 ATS 分数、生成的 PDF 报告和 HTML 跟踪页面。

运行测试

npm test

40 个测试覆盖解析、评分、"绝不虚构"保证、优化、跟踪、报告以及端到端工具流水线。

下载（Claude Desktop 扩展）

从 Releases 页面获取即装即用的扩展：

只想要扩展？下载 resumepilot.mcpb，打开 Claude Desktop → 设置 → 扩展，将文件拖入，设置你的数据文件夹，然后将其切换为开启。

安装到 Claude Desktop

两种方式——完整指南见 docs/INSTALL.md：

• 一键桌面扩展： npm run bundle 生成 resumepilot.mcpb；将其拖入 Claude Desktop → 设置 → 扩展，设置你的数据文件夹，切换为开启。（该捆绑包内嵌了原生 SQLite 二进制文件，因此请在你自己的操作系统上构建——一条命令——适用于 macOS/Windows。）

• 手动 MCP 配置： 从源码构建并添加一个 mcpServers 条目。

连接到 Claude Desktop（手动配置）

1. 构建：npm run build（生成 dist/src/index.js）。

2. 打开你的 Claude Desktop 配置文件：

   • macOS：~/Library/Application Support/Claude/claude_desktop_config.json

   • Windows：%APPDATA%\Claude\claude_desktop_config.json

3. 添加服务器（参见 docs/claude_desktop_config.example.json），使用绝对路径：

   {
     "mcpServers": {
       "resumepilot": {
         "command": "node",
         "args": ["/ABSOLUTE/PATH/TO/resumepilot-mcp/dist/src/index.js"],
         "env": {
           "RESUMEPILOT_DATA_DIR": "/ABSOLUTE/PATH/TO/your-private-data",
           "ATS_TARGET_SCORE": "90"
         }
       }
     }
   }

4. 完全退出并重新打开 Claude Desktop。ResumePilot 的工具将出现在工具（🔌）菜单下。

使用方法

只需说：

"Start my ResumePilot job application process."（开始我的 ResumePilot 求职申请流程。）

Claude 理解该工作流程，并将：

1. 询问你的主简历 → upload_master_resume（给它文件路径）。

2. 解析它，并仅询问缺失的信息 → analyze_master_resume → setup_user_profile。

3. 接收你粘贴的职位描述 → analyze_job（显示原始 ATS 分数 + 差距）。

4. 构建定制简历 → optimize_resume_for_job（原始 vs 优化后的 ATS，PDF + DOCX）。

5. 准备申请 → generate_application_profile → prepare_application。

6. 记录它 → apply_to_job（第一阶段：由你提交；Claude 在你确认后将其标记为 APPLIED）。

7. 跟踪它 → update_application_tracking / search_application_emails。

8. 生成最终报告 → generate_application_report（PDF + 跟踪页面）。

示例提示

• "这是我的简历：/Users/me/Documents/resume.pdf。设置我的个人资料。"

• "根据我的简历分析这份工作：<粘贴 JD>"

• "为申请 1 优化我的简历，并显示优化前后的 ATS 分数。"

• "哪些地方有变化，哪些地方你无法验证？"

• "生成我的申请报告。"

配置（.env）

安全与隐私

• 你的数据保留在你的机器上，位于 RESUMEPILOT_DATA_DIR 下（已被 git 忽略）。

• 绝不存储第三方密码或 OTP；未来的集成使用官方 OAuth/会话流程，令牌不会出现在日志中。

• 日志仅输出到 stderr，并会对看似机密的值进行脱敏。

• 随时删除数据目录即可清除你的数据。

项目结构

src/
├── index.ts, server.ts          # MCP stdio server + tool registration
├── context.ts                   # composition root
├── tools/                       # 17 MCP tools (thin, Zod-validated)
├── services/                    # parsing, scoring, optimization, tracking, reports
├── providers/                   # jobs / applications / email adapters (+ registries)
├── database/                    # SQLite schema + repository
├── models/                      # Zod schemas & types
└── utils/                       # config, logger, text/keyword processing, ids
tests/                           # vitest suite (40 tests)
docs/                            # ARCHITECTURE.md, Claude Desktop config
scripts/demo.ts                  # offline end-to-end demo

路线图

第二阶段：通用搜索适配器、工作池、去重、排序、≤1,000 个职位 · 第三阶段：受支持的职位来源集成 · 第四阶段：申请适配器 · 第五阶段：Gmail 跟踪（OAuth）· 第六阶段：托管跟踪 UI + 打包。

许可证

MIT——参见 LICENSE。