CV Forge

CV Forge

Forge powerful, ATS-friendly CVs tailored to any job requirement.

An intelligent MCP (Model Context Protocol) server that analyzes job postings and crafts perfectly-matched CVs.

Features

• Parse Job Requirements: Extract key skills, qualifications, email addresses, and hiring manager names from job postings
• Generate Tailored CVs: Create customized CV content based on user profile and job requirements
• Cover Letter Generation: Generate personalized cover letters tailored to specific job applications
• Email Template Creation: Create professional email templates with automatic email address detection
• Complete Application Packages: Generate CV, cover letter, and email template in one command
• PDF by Default: Automatically generates professional PDF documents when no format is specified
• Multiple Output Formats: Generate documents in PDF (default), HTML, Markdown, and text formats
• Professional PDF Generation: Create publication-ready PDF documents with professional styling
• ATS-Friendly: Optimized for Applicant Tracking Systems with proper keyword placement
• Smart Contact Extraction: Automatically extracts email addresses and hiring manager names from job descriptions

Star History

Installation

Via npm (Recommended)

Install globally:

npm install -g cv-forge

Or install locally in your project:

npm install cv-forge

From Source

1. Clone this repository
2. Install dependencies:

   npm install

1. Build the project:

   npm run build

Usage

Connecting to Claude Desktop

To use this MCP server with Claude Desktop, you need to add it to your Claude configuration file.

Step 1: Install cv-forge

npm install -g cv-forge

Step 2: Find your Claude Desktop config file

• Windows: %APPDATA%\Claude\claude_desktop_config.json
• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Linux: ~/.config/Claude/claude_desktop_config.json

Step 3: Add the MCP server to your config

For global installation, add this to your claude_desktop_config.json file:

{

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

Or if installed locally, specify the full path:

{

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

Step 4: (Optional) Add environment configuration

You can customize the server with environment variables:

{

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

Step 5: Restart Claude Desktop After adding the configuration, restart Claude Desktop application.

Step 6: Verify Connection In Claude Desktop, you should see the CV Forge tools available. You can ask Claude to use tools like:

• "Parse this job posting for me"
• "Generate a tailored CV based on my profile and this job"
• "Save my CV as a PDF file"

Running the MCP Server Standalone (for testing)

You can also run the server directly for testing:

npm start

The server runs on stdio and communicates via the Model Context Protocol.

Available Tools

1. parse_job_requirements

Parses job requirements and extracts key information for CV tailoring.

Parameters:

• jobTitle (string, required): The job title/position
• company (string, required): Company name
• jobDescription (string, required): Full job description text
• requirements (array, optional): Specific requirements if separated
• preferredSkills (array, optional): Preferred skills if separated
• location (string, optional): Job location
• salaryRange (string, optional): Salary range if provided

2. generate_cv_data

Generates tailored CV content based on user profile and job requirements.

Parameters:

• userProfile (object, required): Complete user profile information
• jobRequirements (object, required): Job requirements object

User Profile Structure:

{

"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

Saves CV content as a formatted text file.

Parameters:

• cvData (object, required): Tailored CV data object (from generate_cv_data)
• outputPath (string, required): Directory path where the CV should be saved
• fileName (string, optional): Custom filename (without extension), defaults to "generated_cv"

4. generate_cv (Recommended - Main CV Generation Tool)

Generate tailored CV and save to specified location or default folder. Defaults to PDF format if no format is specified.

Parameters:

• userProfile (object, required): Complete user profile information
• jobRequirements (object, required): Job requirements object
• outputPath (string, optional): Directory path where the CV should be saved (uses DEFAULT_OUTPUT_PATH if not provided)
• fileName (string, optional): Custom filename (without extension), defaults to "professional_cv"
• format (string, optional): Output format - "pdf" (default), "html", or "markdown"
• pageSize (string, optional): PDF page size (e.g., 'A4', 'Letter', 'Legal') - uses PDF_PAGE_SIZE env var if not provided
• margins (object, optional): PDF margins with top, right, bottom, left properties (e.g., '10mm', '0.8in') - uses PDF_MARGIN_* env vars if not provided

5. generate_and_save_cv_pdf (Legacy - Use generate_cv instead)

Generate tailored CV and save directly as professional PDF (combines CV generation and PDF creation in one step).

Parameters:

• userProfile (object, required): Complete user profile information
• jobRequirements (object, required): Job requirements object
• outputPath (string, optional): Directory path where the CV should be saved (uses DEFAULT_OUTPUT_PATH if not provided)
• fileName (string, optional): Custom filename (without extension), defaults to "professional_cv"

6. generate_and_save_cv_markdown (Recommended)

Generate tailored CV and save directly as Markdown (combines CV generation and Markdown creation in one step).

Parameters:

• userProfile (object, required): Complete user profile information
• jobRequirements (object, required): Job requirements object
• outputPath (string, required): Directory path where the CV should be saved
• fileName (string, optional): Custom filename (without extension), defaults to "cv_markdown"

7. generate_and_save_cv_html (Recommended)

Generate tailored CV and save directly as HTML (combines CV generation and HTML creation in one step).

Parameters:

• userProfile (object, required): Complete user profile information
• jobRequirements (object, required): Job requirements object
• outputPath (string, required): Directory path where the CV should be saved
• fileName (string, optional): Custom filename (without extension), defaults to "cv_html"

8. generate_cv_pdf (Advanced)

Generate and save CV as a professional PDF document from pre-generated CV data.

Parameters:

• cvData (object, required): Tailored CV data object (from generate_cv_data)
• outputPath (string, required): Directory path where the CV should be saved
• fileName (string, optional): Custom filename (without extension), defaults to "professional_cv"

9. generate_cv_markdown (Advanced)

Generate CV as Markdown format from pre-generated CV data.

Parameters:

• cvData (object, required): Tailored CV data object (from generate_cv_data)
• outputPath (string, required): Directory path where the CV should be saved
• fileName (string, optional): Custom filename (without extension), defaults to "cv_markdown"

10. generate_cv_html (Advanced)

Generate CV as styled HTML document from pre-generated CV data.

Parameters:

• cvData (object, required): Tailored CV data object (from generate_cv_data)
• outputPath (string, required): Directory path where the CV should be saved
• fileName (string, optional): Custom filename (without extension), defaults to "cv_web"

Cover Letter and Email Template Tools

11. generate_cover_letter (Recommended)

Generate a tailored cover letter for a specific job application. Returns formatted text that can be displayed on screen or saved as PDF.

Parameters:

• userProfile (object, required): Complete user profile information
• jobRequirements (object, required): Job requirements object
• hiringManagerName (string, optional): Name of the hiring manager if known
• format (string, optional): Output format - "text" (default) for on-screen display, "html" for styled viewing

12. save_cover_letter_pdf

Generate and save a cover letter as PDF to specified location. Automatically extracts email addresses and hiring manager names from job descriptions.

Parameters:

• userProfile (object, required): Complete user profile information
• jobRequirements (object, required): Job requirements object
• outputPath (string, optional): Directory path where the cover letter should be saved
• fileName (string, optional): Custom filename (without extension), defaults to "cover_letter"
• hiringManagerName (string, optional): Name of the hiring manager if known
• pageSize (string, optional): PDF page size (e.g., 'A4', 'Letter', 'Legal')
• margins (object, optional): PDF margins with top, right, bottom, left properties

13. generate_email_template

Generate a professional email template for job application. Automatically detects email addresses from job description.

Parameters:

• userProfile (object, required): Complete user profile information
• jobRequirements (object, required): Job requirements object
• templateType (string, optional): Type of email template - "application" (default), "follow_up", "inquiry", "thank_you"
• recipientEmail (string, optional): Recipient email address (optional, will use extracted email from job description if available)
• hiringManagerName (string, optional): Name of the hiring manager if known

14. draft_complete_application (Recommended - One-Stop Solution)

Draft a complete job application package: CV, cover letter, and email template. Automatically generates PDF CV and cover letter, plus email template if email address is found in the job description.

Parameters:

• userProfile (object, required): Complete user profile information
• jobRequirements (obj