Cv Forge

🚀 CV Forge

CV Forge 是一款強大的工具，它能根據任何職位要求量身打造出符合 ATS（申請人跟蹤系統）的簡歷。它是一個智能的 MCP（模型上下文協議）服務器，能夠分析招聘信息，並生成與之完美匹配的簡歷。

✨ 主要特性

• 解析職位要求：從招聘信息中提取關鍵技能、任職資格、電子郵件地址和招聘經理姓名。
• 生成定製簡歷：根據用戶資料和職位要求創建定製的簡歷內容。
• 生成求職信：為特定的職位申請生成個性化的求職信。
• 創建電子郵件模板：創建專業的電子郵件模板，並自動檢測電子郵件地址。
• 生成完整申請包：通過一個命令生成簡歷、求職信和電子郵件模板。
• 默認生成 PDF：在未指定格式時，自動生成專業的 PDF 文檔。
• 支持多種輸出格式：可生成 PDF（默認）、HTML、Markdown 和純文本格式的文檔。
• 生成專業 PDF：創建具有專業樣式、可用於發佈的 PDF 文檔。
• 適配 ATS：通過合理放置關鍵詞，優化簡歷以適應申請人跟蹤系統。
• 智能提取聯繫人信息：自動從職位描述中提取電子郵件地址和招聘經理姓名。

📦 安裝指南

通過 npm（推薦）

全局安裝：

npm install -g cv-forge

或者在項目中本地安裝：

npm install cv-forge

從源代碼安裝

1. 克隆此倉庫。
2. 安裝依賴項：

   npm install
   

3. 構建項目：

   npm run build
   

💻 使用示例

連接到 Claude Desktop

要將此 MCP 服務器與 Claude Desktop 一起使用，您需要將其添加到 Claude 配置文件中。 步驟 1：安裝 cv-forge

npm install -g cv-forge

步驟 2：找到您的 Claude Desktop 配置文件

• Windows：%APPDATA%\Claude\claude_desktop_config.json
• macOS：~/Library/Application Support/Claude/claude_desktop_config.json
• Linux：~/.config/Claude/claude_desktop_config.json 步驟 3：將 MCP 服務器添加到您的配置中 對於全局安裝，將以下內容添加到您的 claude_desktop_config.json 文件中：

{
  "mcpServers": {
    "cv-forge": {
      "command": "cv-forge"
    }
  }
}

如果是本地安裝，請指定完整路徑：

{
  "mcpServers": {
    "cv-forge": {
      "command": "node",
      "args": ["d:/TopSecret/cv-forge/build/index.js"],
      "cwd": "d:/TopSecret/cv-forge"
    }
  }
}

步驟 4：（可選）添加環境配置 您可以使用環境變量自定義服務器：

{
  "mcpServers": {
    "cv-forge": {
      "command": "cv-forge",
      "env": {
        "DEFAULT_OUTPUT_PATH": "D:/CV",
        "PDF_BASE_FONT_SIZE": "12px",
        "PDF_LINE_HEIGHT": "1.4"
      }
    }
  }
}

步驟 5：重啟 Claude Desktop 添加配置後，重啟 Claude Desktop 應用程序。 步驟 6：驗證連接 在 Claude Desktop 中，您應該可以看到 CV Forge 工具。您可以要求 Claude 使用以下工具：

• “幫我解析這份招聘信息”
• “根據我的資料和這份職位生成一份定製簡歷”
• “將我的簡歷保存為 PDF 文件”

獨立運行 MCP 服務器（用於測試）

您也可以直接運行服務器進行測試：

npm start

服務器通過標準輸入輸出運行，並通過模型上下文協議進行通信。

可用工具

1. parse_job_requirements

解析職位要求並提取用於定製簡歷的關鍵信息。 參數：

• jobTitle（字符串，必填）：職位名稱。
• company（字符串，必填）：公司名稱。
• jobDescription（字符串，必填）：完整的職位描述文本。
• requirements（數組，可選）：如果有單獨列出的特定要求。
• preferredSkills（數組，可選）：如果有單獨列出的首選技能。
• location（字符串，可選）：工作地點。
• salaryRange（字符串，可選）：如果提供了薪資範圍。

2. generate_cv_data

根據用戶資料和職位要求生成定製的簡歷內容。 參數：

• userProfile（對象，必填）：完整的用戶資料信息。
• jobRequirements（對象，必填）：職位要求對象。 用戶資料結構：

{
  "personalInfo": {
    "fullName": "John Doe",
    "email": "john@example.com",
    "phone": "+1-555-0123",
    "location": "City, State",
    "linkedIn": "linkedin.com/in/johndoe",
    "github": "github.com/johndoe",
    "website": "johndoe.com"
  },
  "summary": "Professional summary text...",
  "experience": [
    {
      "jobTitle": "Software Engineer",
      "company": "Tech Corp",
      "location": "City, State",
      "startDate": "2020-01",
      "endDate": "2023-12",
      "description": "Job description...",
      "achievements": [
        "Achievement 1",
        "Achievement 2"
      ]
    }
  ],
  "education": [
    {
      "degree": "Bachelor of Science in Computer Science",
      "institution": "University Name",
      "location": "City, State",
      "graduationYear": "2020",
      "gpa": "3.8",
      "honors": ["Magna Cum Laude"]
    }
  ],
  "skills": {
    "technical": ["JavaScript", "Python", "React"],
    "soft": ["Leadership", "Communication"],
    "languages": ["English", "Spanish"],
    "certifications": ["AWS Certified"]
  },
  "projects": [
    {
      "name": "Project Name",
      "description": "Project description...",
      "technologies": ["React", "Node.js"],
      "url": "github.com/johndoe/project"
    }
  ]
}

3. save_cv_text

將簡歷內容保存為格式化的文本文件。 參數：

• cvData（對象，必填）：定製的簡歷數據對象（來自 generate_cv_data）。
• outputPath（字符串，必填）：簡歷應保存的目錄路徑。
• fileName（字符串，可選）：自定義文件名（不帶擴展名），默認為 "generated_cv"。

4. generate_cv（推薦 - 主要簡歷生成工具）

生成定製簡歷並保存到指定位置或默認文件夾。如果未指定格式，默認使用 PDF 格式。 參數：

• userProfile（對象，必填）：完整的用戶資料信息。
• jobRequirements（對象，必填）：職位要求對象。
• outputPath（字符串，可選）：簡歷應保存的目錄路徑（如果未提供，則使用 DEFAULT_OUTPUT_PATH）。
• fileName（字符串，可選）：自定義文件名（不帶擴展名），默認為 "professional_cv"。
• format（字符串，可選）：輸出格式 - "pdf"（默認）、"html" 或 "markdown"。
• pageSize（字符串，可選）：PDF 頁面大小（例如，'A4'、'Letter'、'Legal'） - 如果未提供，則使用 PDF_PAGE_SIZE 環境變量。
• margins（對象，可選）：PDF 邊距，包含 top、right、bottom、left 屬性（例如，'10mm'、'0.8in'） - 如果未提供，則使用 PDF_MARGIN_* 環境變量。

5. generate_and_save_cv_pdf（舊版 - 建議使用 generate_cv）

生成定製簡歷並直接保存為專業的 PDF（將簡歷生成和 PDF 創建合併為一步）。 參數：

• userProfile（對象，必填）：完整的用戶資料信息。
• jobRequirements（對象，必填）：職位要求對象。
• outputPath（字符串，可選）：簡歷應保存的目錄路徑（如果未提供，則使用 DEFAULT_OUTPUT_PATH）。
• fileName（字符串，可選）：自定義文件名（不帶擴展名），默認為 "professional_cv"。

6. generate_and_save_cv_markdown（推薦）

生成定製簡歷並直接保存為 Markdown（將簡歷生成和 Markdown 創建合併為一步）。 參數：

• userProfile（對象，必填）：完整的用戶資料信息。
• jobRequirements（對象，必填）：職位要求對象。
• outputPath（字符串，必填）：簡歷應保存的目錄路徑。
• fileName（字符串，可選）：自定義文件名（不帶擴展名），默認為 "cv_markdown"。

7. generate_and_save_cv_html（推薦）

生成定製簡歷並直接保存為 HTML（將簡歷生成和 HTML 創建合併為一步）。 參數：

• userProfile（對象，必填）：完整的用戶資料信息。
• jobRequirements（對象，必填）：職位要求對象。
• outputPath（字符串，必填）：簡歷應保存的目錄路徑。
• fileName（字符串，可選）：自定義文件名（不帶擴展名），默認為 "cv_html"。

8. generate_cv_pdf（高級）

根據預先生成的簡歷數據生成並保存簡歷為專業的 PDF 文檔。 參數：

• cvData（對象，必填）：定製的簡歷數據對象（來自 generate_cv_data）。
• outputPath（字符串，必填）：簡歷應保存的目錄路徑。
• fileName（字符串，可選）：自定義文件名（不帶擴展名），默認為 "professional_cv"。

9. generate_cv_markdown（高級）

根據預先生成的簡歷數據以 Markdown 格式生成簡歷。 參數：

• cvData（對象，必填）：定製的簡歷數據對象（來自 generate_cv_data）。
• outputPath（字符串，必填）：簡歷應保存的目錄路徑。
• fileName（字符串，可選）：自定義文件名（不帶擴展名），默認為 "cv_markdown"。

10. generate_cv_html（高級）

根據預先生成的簡歷數據生成樣式化的 HTML 簡歷文檔。 參數：

• cvData（對象，必填）：定製的簡歷數據對象（來自 generate_cv_data）。
• outputPath（字符串，必填）：簡歷應保存的目錄路徑。
• fileName（字符串，可選）：自定義文件名（不帶擴展名），默認為 "cv_web"。

求職信和電子郵件模板工具

11. generate_cover_letter（推薦）

為特定的職位申請生成定製的求職信。返回格式化的文本，可在屏幕上顯示或保存為 PDF。 參數：

• userProfile（對象，必填）：完整的用戶資料信息。
• jobRequirements（對象，必填）：職位要求對象。
• hiringManagerName（字符串，可選）：如果知道招聘經理的姓名。
• format（字符串，可選）：輸出格式 - "text"（默認）用於屏幕顯示，"html" 用於樣式化查看。

12. save_cover_letter_pdf

生成求職信並將其保存為 PDF 到指定位置。自動從職位描述中提取電子郵件地址和招聘經理姓名。 參數：

• userProfile（對象，必填）：完整的用戶資料信息。
• jobRequirements（對象，必填）：職位要求對象。
• outputPath（字符串，可選）：求職信應保存的目錄路徑。
• fileName（字符串，可選）：自定義文件名（不帶擴展名），默認為 "cover_letter"。
• hiringManagerName（字符串，可選）：如果知道招聘經理的姓名。
• pageSize（字符串，可選）：PDF 頁面大小（例如，'A4'、'Letter'、'Legal'）。
• margins（對象，可選）：PDF 邊距，包含 top、right、bottom、left 屬性。

13. generate_email_template

為職位申請生成專業的電子郵件模板。自動從職位描述中檢測電子郵件地址。 參數：

• userProfile（對象，必填）：完整的用戶資料信息。
• jobRequirements（對象，必填）：職位要求對象。
• templateType（字符串，可選）：電子郵件模板類型 - "application"（默認）、"follow_up"、"inquiry"、"thank_you"。
• recipientEmail（字符串，可選）：收件人電子郵件地址（可選，如果可用，將使用從職位描述中提取的電子郵件）。
• hiringManagerName（字符串，可選）：如果知道招聘經理的姓名。

14. draft_complete_application（推薦 - 一站式解決方案）

起草完整的職位申請包：簡歷、求職信和電子郵件模板。如果在職位描述中找到電子郵件地址，將自動生成 PDF 簡歷和求職信，以及電子郵件模板。 參數：

• userProfile（對象，必填）：完整的用戶資料信息。
• jobRequirements（對象，必填）：職位要求對象。
• outputPath（字符串，可選）：文件應保存的目錄路徑。
• baseFileName（字符串，可選）：生成文件的基本文件名（不帶擴展名），默認為 "job_application"。
• hiringManagerName（字符串，可選）：如果知道招聘經理的姓名。

📚 詳細文檔

配置

環境變量

MCP 服務器通過 Claude Desktop 配置中的環境變量支持各種配置選項：

{
  "mcpServers": {
    "cv-forge": {
      "command": "node",
      "args": ["path/to/cv-forge/build/index.js"],
      "cwd": "path/to/cv-forge",
      "env": {
        "DEFAULT_OUTPUT_PATH": "D:/CV",
        "TEMP_DIR": "C:/Users/YourName/AppData/Local/Temp/cv-maker",
        "PDF_TIMEOUT": "300000",
        "PDF_PAGE_SIZE": "A4",
        "PDF_MARGIN_TOP": "10mm",
        "PDF_MARGIN_RIGHT": "10mm",
        "PDF_MARGIN_BOTTOM": "10mm",
        "PDF_MARGIN_LEFT": "10mm",
        "PDF_BASE_FONT_SIZE": "12px",
        "PDF_LINE_HEIGHT": "1.4",
        "PDF_H1_FONT_SIZE": "20px",
        "PDF_H2_FONT_SIZE": "15px",
        "PDF_H3_FONT_SIZE": "13px",
        "PDF_PARAGRAPH_SPACING": "8px",
        "PDF_SECTION_SPACING": "12px"
      }
    }
  }
}

配置選項：

• DEFAULT_OUTPUT_PATH：保存簡歷文件的默認目錄（當 outputPath 未提供或為 "./" 時）。
• TEMP_DIR：PDF 生成過程中臨時文件的目錄。
• PDF_TIMEOUT：PDF 生成的超時時間（以毫秒為單位）。
• PDF_PAGE_SIZE：默認的 PDF 頁面大小 - 默認為 'A4'。
  • 常見大小：'A4'（210×297mm）、'Letter'（8.5×11 英寸）、'Legal'（8.5×14 英寸）。
• PDF_MARGIN_*：PDF 頁面邊距（上、右、下、左） - 默認為 '10mm'。
• PDF_BASE_FONT_SIZE：簡歷正文文本的基本字體大小（12px ≈ MS Word 9pt，13px ≈ 10pt）。
• PDF_LINE_HEIGHT：文本的行高（推薦 1.4 以實現緊湊佈局）。
• PDF_H1_FONT_SIZE：姓名/標題的字體大小。
• PDF_H2_FONT_SIZE：章節標題的字體大小。
• PDF_H3_FONT_SIZE：職位名稱和子章節的字體大小。
• PDF_PARAGRAPH_SPACING：段落間距。
• PDF_SECTION_SPACING：主要章節之間的間距。

使用 Claude Desktop 的示例

連接到 Claude Desktop 後，您可以使用自然語言與簡歷生成器進行交互：

1. 解析職位要求

“幫我解析這份招聘信息：

職位名稱：高級軟件工程師
公司：TechCorp Inc
描述：我們正在尋找一名具有 5 年以上 JavaScript、React 和 Node.js 經驗的高級軟件工程師。必須具備雲平臺和敏捷方法的經驗。需要具備較強的溝通能力。”

2. 生成定製簡歷（簡單的一步流程 - 默認生成 PDF）

“根據這份招聘信息為我生成一份定製簡歷：

職位名稱：高級軟件工程師
公司：TechCorp Inc
職位描述：我們正在尋找一名具有 5 年以上 JavaScript、React 和 Node.js 經驗的高級軟件工程師。必須具備雲平臺和敏捷方法的經驗。

我的資料：
- 全名：John Doe
- 電子郵件：john@example.com
- 電話：+1-555-0123
- 經驗：在多家公司擔任軟件工程師 6 年
- 技能：JavaScript、Python、React、Node.js、AWS、Docker
- 教育背景：州立大學計算機科學學士學位

請將其保存到 C:\Users\John\Documents\CVs，文件名為 'john_doe_senior_engineer_techcorp'”

注意：除非您指定其他格式，否則這將自動生成一個 PDF 文件（默認格式）。

3. 生成不同格式的簡歷

“你能為我生成多種格式的簡歷嗎？我需要：
1. 一份用於申請的專業 PDF（默認格式）
2. 一份用於我的 GitHub 的 Markdown 版本
3. 一份用於我的網站的 HTML 版本

將它們全部保存到 C:\Users\John\Documents\CVs，基本文件名為 'john_doe_cv'”

或者明確指定格式：

“以 HTML 格式生成我的簡歷並保存到 C:\Users\John\Documents\CVs”

或者為 PDF 指定自定義頁面大小和邊距：

“以 Letter 頁面大小和四周 1 英寸的邊距將我的簡歷生成 PDF，保存到 C:\Users\John\Documents\CVs”

4. 生成求職信

“為 TechCorp Inc 的高級軟件工程師職位生成一封求職信。職位描述中提到招聘經理是 Sarah Johnson，申請應發送至 careers@techcorp.com。”

5. 生成電子郵件模板

“為申請 TechCorp Inc 的高級軟件工程師職位創建一個電子郵件模板。招聘信息中包含電子郵件 careers@techcorp.com，並提到 Sarah Johnson 是招聘經理。”

6. 起草完整申請包（推薦）

“為 TechCorp Inc 的高級軟件工程師職位起草一個完整的職位申請包。包括簡歷、求職信和電子郵件模板。將所有內容保存到 C:\Users\John\Documents\Applications，基本文件名為 'techcorp_application'。”

這將生成：

• techcorp_application_CV.pdf - 定製簡歷
• techcorp_application_Cover_Letter.pdf - 專業求職信
• techcorp_application_Email_Template.txt - 電子郵件模板（如果在招聘信息中找到電子郵件地址）

7. 生成跟進電子郵件模板

“為我上週申請的 TechCorp Inc 的高級軟件工程師職位生成一個跟進電子郵件模板。”

直接使用工具的示例

如果您想直接使用工具（高級用法）：

1. 解析招聘信息：

{
  "tool": "parse_job_requirements",
  "args": {
    "jobTitle": "Senior Software Engineer",
    "company": "TechCorp Inc",
    "jobDescription": "We are looking for a Senior Software Engineer with 5+ years of experience in JavaScript, React, and Node.js. Must have experience with cloud platforms and agile methodologies."
  }
}

2. 生成定製簡歷：

{
  "tool": "generate_cv_data", 
  "args": {
    "userProfile": { /* 用戶資料對象 */ },
    "jobRequirements": { /* 職位要求對象 */ }
  }
}

3. 生成 PDF 簡歷：

{
  "tool": "generate_cv_pdf",
  "args": {
    "cvData": { /* 定製的簡歷數據 */ },
    "outputPath": "C:\\Users\\YourName\\Documents\\CVs",
    "fileName": "senior_engineer_techcorp_cv"
  }
}

4. 生成 Markdown 簡歷：

{
  "tool": "generate_cv_markdown",
  "args": {
    "cvData": { /* 定製的簡歷數據 */ },
    "outputPath": "C:\\Users\\YourName\\Documents\\CVs",
    "fileName": "cv_for_github"
  }
}

5. 生成 HTML 簡歷：

{
  "tool": "generate_cv_html",
  "args": {
    "cvData": { /* 定製的簡歷數據 */ },
    "outputPath": "C:\\Users\\YourName\\Documents\\CVs",
    "fileName": "web_resume"
  }
}

6. 將簡歷保存為文本文件：

{
  "tool": "save_cv_text",
  "args": {
    "cvData": { /* 定製的簡歷數據 */ },
    "outputPath": "C:\\Users\\YourName\\Documents\\CVs",
    "fileName": "senior_engineer_techcorp_cv"
  }
}

🔧 技術細節

工作原理

1. 職位分析：服務器解析職位描述以提取：
   • 所需的技術技能
   • 首選的任職資格
   • 公司行業和規模
   • 經驗水平要求
2. 簡歷定製：基於分析結果，它會：
   • 優先考慮相關技能和經驗
   • 調整專業摘要
   • 重新排序並強調匹配的成就
   • 融入特定職位的關鍵詞以優化 ATS
3. 輸出生成：創建格式良好的文本簡歷，該簡歷：
   • 使用適合 ATS 的格式
   • 包含相關關鍵詞
   • 保持專業結構
   • 突出最相關的資格

文件結構

cv-forge/
├── src/
│   ├── index.ts                    # 主 MCP 服務器
│   └── lib/
│       ├── job-parser.ts           # 職位要求解析邏輯
│       ├── cv-generator.ts         # 簡歷定製算法
│       ├── document-generator.ts   # 多格式文檔生成
│       └── word-generator.ts       # （未來）Word 文檔生成
├── build/                          # 編譯後的 JavaScript 文件
├── package.json                    # 項目配置
├── tsconfig.json                   # TypeScript 配置
├── claude_desktop_config.example.json  # 示例配置
└── README.md                       # 本文件

開發

構建

npm run build

啟動開發服務器

npm run dev

項目結構

• src/index.ts：帶有工具註冊的主 MCP 服務器。
• src/lib/job-parser.ts：解析職位要求，提取關鍵信息、電子郵件和招聘經理姓名。
• src/lib/cv-generator.ts：根據職位要求生成定製的簡歷內容。
• src/lib/cover-letter-generator.ts：為職位申請生成個性化的求職信。
• src/lib/email-template-generator.ts：為各種申請場景創建專業的電子郵件模板。
• src/lib/document-generator.ts：多格式文檔生成（PDF、HTML、Markdown）。
• src/lib/word-generator.ts：（未來）Word 文檔生成功能。

故障排除

PDF 未保存到配置的位置

• 確保在您的 Claude Desktop 配置中設置了 DEFAULT_OUTPUT_PATH。
• 更改配置後重啟 Claude Desktop。
• 檢查路徑是否存在，或者應用程序是否有權限創建該路徑。

字體大小過大或過小

• 在環境變量中調整 PDF_BASE_FONT_SIZE（12px ≈ 9pt，13px ≈ 10pt MS Word）。
• 修改 PDF_LINE_HEIGHT 以調整間距。
• 更改後重啟 Claude Desktop。

PDF 生成失敗

• 檢查輸出目錄是否存在且可寫。
• 驗證 TEMP_DIR 路徑是否有效。
• 確保有足夠的磁盤空間。

自定義頁面大小不起作用

• 確保頁面大小是有效的格式（A4、Letter、Legal、A3、A5 等）。
• 檢查 PDF 生成器是否支持該頁面大小。
• 使用標準的頁面大小名稱（區分大小寫）。

自定義邊距未應用

• 使用正確的單位：'mm'、'cm'、'in'、'px'、'pt'。
• 示例：'10mm'、'0.8in'、'72pt'。
• 更改環境變量後重啟 Claude Desktop。

📄 許可證

本項目採用 MIT 許可證。

🤝 貢獻

歡迎貢獻！請隨時提交拉取請求或提出問題以報告錯誤和提出功能請求。