thechandanbhagat/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:
Or install locally in your project:
From Source
1. Clone this repository
2. Install dependencies:
3. Build the project:
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**
**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:
Or if installed locally, specify the full path:
**Step 4: (Optional) Add environment configuration**
You can customize the server with environment variables:
**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:
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:**
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