Resume Generator MCP Server

Resume Generator MCP 服务（已停用）

重要

此 MCP 服务已不再维护。本项目使用的 Resumake 和托管简历渲染 服务均已停用，因此此实现已无法通过原始端点生成 PDF。

可正常使用的简历定制和渲染逻辑已迁移至 tailor-resume skill。 此 skill 在本地运行原始 Resumake v2 LaTeX 生成器，支持全部 九种模板，且不依赖已停用的托管端点。

如需了解新安装和使用说明，请使用维护中的 skill 仓库：

AndreaCadonna/skills - tailor-resume

已归档的 MCP 文档

以下文档仅供历史参考和迁移参考。 调用 LaTeX Resume API 的命令和示例已无法运行。

一种模型上下文协议（MCP）服务，可使用 LaTeX 模板生成专业 PDF 简历。它与 Claude Desktop 无缝集成，可根据结构化数据创建精美简历，并提供高级文件夹管理和整理功能。

功能

• 🎨 9 种专业模板 - 采用高质量 LaTeX 设计
• 📄 PDF 生成 - 通过 LaTeX Resume API 提供专业级输出
• 🔧 MCP 集成 - 可直接与 Claude Desktop 配合使用
• 📝 结构化数据 - 易于使用的简历数据 JSON 架构
• 🎯 可自定义 - 自定义标题、章节和模板选择
• 💼 专业品质 - 基于 LaTeX 的渲染，呈现清晰、专业的效果
• 🤖 AI 驱动 - 通过 Claude 使用自然语言创建简历
• 📁 文件夹管理 - 创建自定义文件夹，按职位、公司或类别整理简历
• 🗂️ 目录导航 - 使用内置文件浏览器列出并浏览简历集
• 🛡️ 路径安全 - 内置路径清理功能，可避免安全问题

概述

此 MCP 服务充当 Claude Desktop 与专业简历生成之间的桥梁。只需用自然语言向 Claude 描述简历要求，它便会使用 LaTeX 模板生成排版精美的 PDF 简历。现在还提供高级整理功能，让你的简历井井有条！

先决条件

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

安装

1. 克隆仓库：

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

2. 安装依赖项：

   npm install
   

3. 配置 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"]
       }
     }
   }
   

4. 重启 Claude Desktop 以加载 MCP 服务。

用法

配置完成后，你可以在 Claude Desktop 中直接使用自然语言调用简历生成器。此工具灵活且智能——你可以提供完整的工作经历，让 Claude 针对各种情况撰写合适的简历。

工作原理

1. 分享你的经历 - 向 Claude 提供完整的职业背景、教育经历、技能和成就
2. 指定目标 - 可选地附上职位描述，或说明目标职位类型
3. 整理简历 - 通过自定义文件夹结构选择每份简历的保存位置
4. 获取定制结果 - Claude 会自动为你的特定目标挑选并突出最相关的经历

请求示例

生成基础简历

Create a resume for a software engineer with 5 years experience in React and Node.js

将简历整理到自定义文件夹

Generate a resume for a Senior Developer position at Google and save it in a "FAANG-applications/google" folder

个人经历 + 目标职位 + 整理方式

Here's my background:
- 8 years as a software developer
- Worked at: Microsoft (2018-2021), Google (2021-2023), startup CTO (2023-present)
- Skills: Python, JavaScript, AWS, team leadership, architecture design
- Education: MS Computer Science from MIT
- Led teams of 5-15 people, built systems serving millions of users

I'm applying for this Senior Engineering Manager position at Netflix:
[paste job description here]

Generate a resume that highlights my most relevant experience for this role and save it in "streaming-companies/netflix" folder.

文件夹管理

Create a folder structure for organizing my job applications: "job-search-2024/tech-companies" and "job-search-2024/startups"

Show me what resumes I have in my "tech-companies" folder

按模板生成并整理

Generate a resume using template 3 for John Doe and save it in the "personal/drafts" folder with the filename "john-doe-senior-dev"

职业转型场景并整理

I have 10 years in finance but want to transition to product management. Here's my experience:
[detailed background]

Create a resume that emphasizes my transferable skills for a Product Manager role at a tech company and save it in "career-transition/product-management" folder.

智能整理功能

• 🗂️ 自动创建文件夹 - 生成简历时自动创建文件夹
• 📁 自定义目录结构 - 按公司、职位类型、行业或任何适合你的方式整理
• 🔍 目录浏览器 - 列出任意文件夹的内容，查看你的简历集合
• 📊 文件信息 - 查看文件大小、创建日期，并按元数据整理
• 🛡️ 路径安全 - 内置净化机制，可防止目录遍历和无效字符

整理示例

按公司：

• 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（字符串，可选）：generated-resumes 目录中的自定义文件夹路径

示例：

{
  "resumeData": {
    /* resume data */
  },
  "filename": "john-doe-senior-engineer",
  "folderPath": "job-applications/tech-companies/google"
}

create_folder

在 generated-resumes 目录中创建新文件夹。

参数：

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

示例：

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

list_folders

列出 generated-resumes 目录中的所有文件夹和文件。

参数：

• path（字符串，可选）：要列出的特定子目录

示例：

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

create_resume_template

使用占位数据创建模板结构。

参数：

• templateNumber（整数，1-9）：用作基础的模板

简历数据结构

{
  "selectedTemplate": 1,
  "basics": {
    "name": "John Doe",
    "email": "[email protected]",
    "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": "2022",
      "endDate": "Present",
      "highlights": [
        "Developed web applications using React and Node.js",
        "Led team of 3 developers on key projects"
      ]
    }
  ],
  "education": [
    {
      "institution": "University of California",
      "area": "Computer Science",
      "studyType": "Bachelor of Science",
      "startDate": "2018",
      "endDate": "2022",
      "location": "Berkeley, CA"
    }
  ],
  "skills": [
    {
      "name": "Frontend",
      "keywords": ["React", "TypeScript", "HTML5", "CSS3"]
    }
  ],
  "projects": [
    {
      "name": "Portfolio Website",
      "description": "Personal portfolio built with 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

故障排除

常见问题

1. “找不到方法”错误：

   • 配置后请确保重启 Claude Desktop
   • 检查 claude_desktop_config.json 中的路径是否正确

2. 连接错误：

   • 检查互联网连接
   • 检查是否可以访问 LaTeX Resume API

3. 未生成 PDF：

   • 检查 generated-resumes 目录的权限
   • 确保目录存在且可写入

4. 创建文件夹时出错：

   • 确认 generated-resumes 目录具有写入权限
   • 检查文件夹路径是否包含无效字符

5. 路径相关问题：

   • 文件夹路径会自动进行安全净化
   • 无效字符会替换为下划线
   • 会自动阻止目录遍历尝试（../）

调试模式

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

DEBUG=resume-generator node server.js

开发

项目结构

resume-generator-mcp/
├── server.js              # Main MCP server with folder management
├── package.json           # Dependencies and scripts
├── README.md              # This file
└── generated-resumes/     # Output directory (created automatically)
    └── [organized folders] # Custom folder structure

依赖项

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

安全功能

• 路径清理：防止目录遍历攻击
• 输入验证：验证文件夹路径和文件名
• 范围限制：所有操作仅限于 generated-resumes 目录
• 字符过滤：移除或替换无效的文件系统字符

贡献

1. Fork 此仓库
2. 创建功能分支：git checkout -b feature-name
3. 进行更改并充分测试
4. 提交 Pull Request，并附上清晰的说明

致谢

本项目基于多个优秀的开源项目和服务构建：

LaTeX 简历 API

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

LaTeX 模板

这些精美的简历模板基于 resumake.io 以及更广泛的 LaTeX 社区所提供的设计：

• 伦斯勒职业发展中心
• Byungjin Park - Awesome CV 模板
• Scott Clark - 简洁而专业的设计
• Debarghya Das - 现代简历模板
• Xavier Danaux - 经典 LaTeX 简历样式
• Ratul Saha - 当代设计
• Daniil Belyakov - 极简模板
• Frits Wenneker - 专业 CV 模板

技术栈

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

许可证

MIT © Resume Generator 贡献者

支持

• 🐛 错误报告： GitHub Issues
• 💡 功能请求： GitHub Discussions
• 联系： 请使用 GitHub Issues 获取支持。

更新日志

v2.0.0 - 文件夹管理更新

• ✨ 新增： 在 generated-resumes 目录中自定义文件夹组织
• ✨ 新增： 用于创建有序目录结构的 create_folder 工具
• ✨ 新增： 用于浏览和管理简历集合的 list_folders 工具
• ✨ 新增： 增强 generate_resume，支持 folderPath 参数
• 🛡️ 新增： 路径清理和安全功能
• 📊 新增： 在目录列表中显示文件元数据（大小、日期）
• 🗂️ 新增： 生成简历时自动创建文件夹路径
• 📁 新增： 支持嵌套文件夹结构
• 🔍 新增： 目录导航和文件组织工具

v1.0.0

• 首次发布
• 通过 LaTeX Resume API 支持 9 种 LaTeX 模板
• 通过 Claude Desktop 使用自然语言生成简历
• 实现支持结构化数据的 MCP 服务
• 使用可自定义模板生成专业 PDF

---

为 Claude Desktop 和 MCP 社区倾情打造 ❤️