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
   

3. 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 (

... View full README on GitHub