简历生成-mcp

Name: 简历生成-mcp
Author: AndreaCadonna

作者：AndreaCadonna8 星标更新：2025-10-03

安装使用来源：spider==github.com

项目介绍

简历生成器 MCP 服务器

这是一个使用 LaTeX 模板生成专业 PDF 简历的 Model Context Protocol (MCP) 服务器。它与 Claude Desktop 完美集成，可以从结构化数据中创建精美的简历，并具有高级文件夹管理和组织功能。

功能

🎨 9 个专业模板 - 由高质量的 LaTeX 设计提供支持
📄 PDF 生成 - 通过 LaTeX 简历 API 生成专业级别的输出
🔧 MCP 集成 - 直接与 Claude Desktop 集成
📝 结构化数据 - 易于使用的 JSON 架构用于简历数据
🎯 可定制 - 自定义标题、部分和模板选择
💼 专业质量 - 基于 LaTeX 的渲染，以获得清晰的专业结果
🤖 AI 支持 - 通过 Claude 创建自然语言简历
📁 文件夹管理 - 创建自定义文件夹并按职位、公司或类别整理简历
🗂️ 目录导航 - 使用内置文件浏览器列出和浏览您的简历收藏
🛡️ 安全路径 - 内置路径净化防止安全问题

概览

此 MCP 服务器充当 Claude Desktop 和专业简历生成之间的桥梁。只需用自然语言向 Claude 描述您的简历需求，它将使用 LaTeX 模板生成一个精美排版的 PDF 简历。现在带有高级组织功能，使您的简历保持完美有序！

先决条件

Node.js（v16 或更高版本）
Claude Desktop 应用程序
互联网连接（用于 LaTeX 简历 API）

安装

克隆仓库：

git clone https://github.com/yourusername/resume-generator-mcp.git
cd resume-generator-mcp

安装依赖项：
```
npm install
```
配置 Claude Desktop： 在您的 Claude Desktop MCP 设置文件中添加以下内容：

Windows: %APPDATA%\Claude\claude_desktop_config.json macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Linux: ~/.config/Claude/claude_desktop_config.json
```
{
  "mcpServers": {
    "resume-generator": {
      "command": "node",
      "args": ["path/to/resume-generator-mcp/server.js"]
    }
  }
}
```
重启 Claude Desktop 以加载 MCP 服务器。

使用方法

配置完成后，您可以在 Claude Desktop 中直接使用简历生成器进行自然语言操作。该工具设计灵活且智能——您可以提供完整的从业经历，让 Claude 为您量身打造适合任何情况的完美简历。

工作原理

分享您的经验 - 向 Claude 提供您的完整职业背景、教育、技能和成就
指定目标 - 可选地包括职位描述或提及您要申请的角色类型
组织您的简历 - 选择保存每个简历的自定义文件夹结构
获取定制结果 - Claude 将自动选择并突出显示最相关的经历以匹配您的特定目标

示例请求

基本简历生成

为具有 5 年 React 和 Node.js 经验的软件工程师生成一份简历

带有自定义文件夹的组织简历

为 Google 的高级开发者职位生成一份简历，并将其保存在“FAANG-applications/google”文件夹中

个人历史 + 目标职位 + 组织

这是我的背景：
- 8 年软件开发经验
- 工作经历：Microsoft（2018-2021），Google（2021-2023），初创公司 CTO（2023 至今）
- 技能：Python，JavaScript，AWS，团队领导，架构设计
- 教育：麻省理工学院计算机科学硕士
- 领导过 5 到 15 人的团队，构建服务于数百万用户的系统

我正在申请 Netflix 的高级工程经理职位：
[粘贴职位描述]

生成一份突出我最相关经验的简历，并将其保存在“streaming-companies/netflix”文件夹中。

文件夹管理

创建一个用于组织我的求职申请的文件夹结构：“job-search-2024/tech-companies”和“job-search-2024/startups”

显示我在“tech-companies”文件夹中的简历

模板特定生成与组织

使用模板 3 为 John Doe 生成一份简历，并将其保存在“personal/drafts”文件夹中，文件名为“john-doe-senior-dev”

职业转型场景与组织

我在金融行业工作了 10 年，但想转行到产品管理。这是我的经历：
[详细背景]

为一家科技公司的产品经理职位生成一份简历，强调我的可转移技能，并将其保存在“career-transition/product-management”文件夹中。

智能组织功能

🗂️ 自动文件夹创建 - 在生成简历时自动创建文件夹
📁 自定义目录结构 - 按公司、角色类型、行业或任何适合您的系统进行组织
🔍 目录浏览器 - 列出任何文件夹的内容以查看您的简历收藏
📊 文件信息 - 查看文件大小、创建日期，并根据元数据进行组织
🛡️ 路径安全 - 内置净化防止目录遍历和无效字符

组织示例

按公司：

applications/google/
applications/microsoft/
applications/amazon/

按角色类型：

roles/senior-engineer/
roles/tech-lead/
roles/manager/

按行业：

industries/fintech/
industries/healthcare/
industries/gaming/

按状态：

drafts/
submitted/2024/
archived/old-versions/

智能定制功能

🎯 相关性优化 - 自动优先考虑与目标角色相匹配的经历
📈 成就突出 - 强调量化结果和成就
🔄 技能对齐 - 当提供时，将您的技能与职位要求相匹配
📝 专业格式 - 确保一致且 ATS 友好的格式
🎨 模板选择 - 推荐最适合您行业/角色的模板

Claude 将自动结构化您的信息并生成一份专业 PDF 简历，以满足您的具体目标，并将其保存在您想要的位置。

API 参考

可用工具

`generate_resume`

从结构化数据生成 PDF 简历，可选文件夹组织。

参数：

resumeData (对象)：完整的简历信息
filename (字符串，可选)：PDF 的自定义文件名
folderPath (字符串，可选)：生成简历目录内的自定义文件夹路径

示例：

{
  "resumeData": {
    /* 简历数据 */
  },
  "filename": "john-doe-senior-engineer",
  "folderPath": "job-applications/tech-companies/google"
}

`create_folder`

在生成简历目录内创建新文件夹。

参数：

folderPath (字符串)：要创建的文件夹路径（支持嵌套文件夹）

示例：

{
  "folderPath": "applications/2024/q1"
}

`list_folders`

列出生成简历目录内的所有文件夹和文件。

参数：

path (字符串，可选)：要列出的具体子目录

示例：

{
  "path": "applications/tech-companies"
}

`create_resume_template`

创建带有占位符数据的模板结构。

参数：

templateNumber (整数，1-9)：作为基础的模板编号

简历数据结构

{
  "selectedTemplate": 1,
  "basics": {
    "name": "John Doe",
    "email": "john.doe@example.com",
    "phone": "+1-555-0123",
    "website": "https://johndoe.dev",
    "location": {
      "address": "San Francisco, CA"
    }
  },
  "work": [
    {
      "company": "Tech Corp",
      "position": "Software Engineer",
      "location": "San Francisco, CA",
      "startDate": "2_2022",
      "endDate": "Present",
      "highlights": [
        "使用 React 和 Node.js 开发 Web 应用程序",
        "领导关键项目的 3 名开发人员团队"
      ]
    }
  ],
  "education": [
    {
      "institution": "University of California",
      "area": "Computer Science",
      "studyType": "Bachelor of Science",
      "startDate": "2018",
      "endDate": "2022",
      "location": "Berkeley, CA"
    }
  ],
  "skills": [
    {
      "name": "前端",
      "keywords": ["React", "TypeScript", "HTML5", "CSS3"]
    }
  ],
  "projects": [
    {
      "name": "个人作品集网站",
      "description": "使用 Next.js 构建的个人作品集",
      "url": "https://johndoe.dev",
      "keywords": ["Next.js", "React", "Tailwind CSS"]
    }
  ]
}

配置

文件存储

生成的 PDF 存储在以下组织目录内：

Windows: %LOCALAPPDATA%\AnthropicClaude\app-{version}\generated-resumes\
macOS: ~/Library/Application Support/AnthropicClaude/app-{version}/generated-resumes/
Linux: ~/.local/share/AnthropicClaude/app-{version}/generated-resumes/

目录结构示例

generated-resumes/
├── applications/
│   ├── google/
│   │   ├── john-doe-swe-2024-06-30.pdf
│   │   └── john-doe-senior-2024-06-30.pdf
│   ├── microsoft/
│   └── startups/
├── drafts/
│   └── work-in-progress-2024-06-30.pdf
└── templates/
    └── base-template-2024-06-30.pdf

故障排除

常见问题

“未找到方法”错误：
- 确保在配置后重新启动 Claude Desktop
- 检查 claude_desktop_config.json 中的路径是否正确
连接错误：
- 验证互联网连接
- 检查 LaTeX 简历 API 是否可访问
PDF 未生成：
- 检查生成简历目录的权限
- 确保目录存在且可写
文件夹创建错误：
- 验证生成简历目录的写入权限
- 检查文件夹路径是否包含无效字符
路径相关问题：
- 文件夹路径会自动净化以确保安全
- 无效字符会被替换为下划线
- 尝试目录遍历（../）将被自动阻止

调试模式

通过设置环境变量启用调试日志：

DEBUG=resume-generator node server.js

开发

项目结构

resume-generator-mcp/
├── server.js              # 主 MCP 服务器，带文件夹管理
├── package.json           # 依赖项和脚本
├── README.md              # 此文件
└── generated-resumes/     # 输出目录（自动创建）
    └── [组织文件夹] # 自定义文件夹结构

依赖项

@modelcontextprotocol/sdk：用于服务器实现的 MCP SDK
node-fetch：用于 API 请求的 HTTP 客户端
fs/promises：用于文件夹管理的文件系统操作

安全特性

路径净化：防止目录遍历攻击
输入验证：验证文件夹路径和文件名
作用域限制：所有操作都限制在生成简历目录内
字符过滤：移除或替换无效的文件系统字符

贡献

分叉仓库
创建功能分支：git checkout -b feature-name
进行更改并彻底测试
提交包含明确描述的拉取请求

致谢

该项目基于多个出色的开源项目和服务构建：

LaTeX 简历 API

服务：latexresu.me - 专业的 LaTeX 简历生成 API
致谢：感谢 LaTeX 简历 API 团队提供的后台服务，支持 PDF 生成

LaTeX 模板

美丽的简历模板基于来自 resumake.io 和更广泛的 LaTeX 社区的设计：

伦斯勒职业发展中心
朴炳俊 - Awesome CV 模板
斯科特·克拉克 - 清晰而专业的设计
德巴尔加·达斯 - 现代简历模板
泽维尔·丹诺克斯 - 经典的 LaTeX 简历样式
拉图尔·萨哈 - 当代设计
丹尼尔·贝利亚科夫 - 极简主义模板
弗里茨·温内克 - 专业的 CV 模板

技术栈

MCP (模型上下文协议) - Anthropic 提供的协议规范
Claude Desktop - 集成平台，用于 AI 支持的工具
Node.js - 用于文件夹管理和文件操作的运行时环境
LaTeX - 文档准备系统，用于高质量排版

许可证

支持

🐛 错误报告：GitHub Issues
💡 功能请求：GitHub Discussions
📧 联系：andrea.cadonna@gmail.com

更新日志

v2.0.0 - 文件夹管理更新

✨ 新增：在生成简历目录内自定义文件夹组织
✨ 新增：create_folder 工具用于创建组织良好的目录结构
✨ 新增：list_folders 工具用于浏览和管理简历收藏
✨ 新增：增强 generate_resume，增加 folderPath 参数
🛡️ 新增：路径净化和安全特性
📊 新增：在目录列表中显示文件元数据（大小、日期）
🗂️ 新增：生成简历时自动创建文件夹路径
📁 新增：支持嵌套文件夹结构
🔍 新增：目录导航和文件组织工具

v1.0.0

初始发布
通过 LaTeX 简历 API 支持 9 个 LaTeX 模板
通过 Claude Desktop 实现自然语言简历生成
支持结构化数据的 MCP 服务器实现
专业 PDF 输出，带有可定制模板

为 Claude Desktop 和 MCP 社区制作 ❤️