README.md
Generate professional ATS-friendly CVs as PDF/DOCX from AI conversations.
CV Forge MCP Server
MCP (Model Context Protocol) server for CV Forge. Lets AI assistants generate professional CVs as PDF/DOCX from conversation data.
How It Works
- You describe your experience to the AI (or paste LinkedIn profile text)
- AI fills in the CV template using the
generate_cvtool - AI calls
generate_pdforgenerate_docxto produce the document - You get a PDF/DOCX file and a link to the visual editor for manual tweaks
The MCP server automatically pulls and starts the CV Forge Docker container — no manual setup needed.
Requirements
Quick Start
Claude Code
claude mcp add cv-forge -- uvx cv-forge-mcp
Claude Desktop
Add to ~/.config/claude/claude_desktop_config.json (Linux) or ~/Library/Application Support/Claude/claude_desktop_config.json (macOS):
{
"mcpServers": {
"cv-forge": {
"command": "uvx",
"args": ["cv-forge-mcp"]
}
}
}
Manual install (alternative)
pip install cv-forge-mcp
Available Tools
| Tool | Description |
|---|---|
generate_cv |
Returns an empty CV JSON template for the AI to fill in |
generate_pdf |
Generates ATS PDF from CV data, returns file path + editor URL |
generate_docx |
Generates ATS DOCX from CV data, returns file path + editor URL |
AI Instructions
See `INSTRUCTIONS.md` for the full system prompt and workflow guidelines for AI assistants using CV Forge.
Links
- CV Forge: https://github.com/Guid-Lab/cv-forge
- Live Demo: https://cv.guidlab.pl
- Docker Hub: https://hub.docker.com/r/guidlab/cv-forge
Tools (3)
generate_cvReturns an empty CV JSON template for the AI to fill in.generate_pdfGenerates ATS PDF from CV data, returns file path and editor URL.generate_docxGenerates ATS DOCX from CV data, returns file path and editor URL.Configuration
claude_desktop_config.json
{"mcpServers": {"cv-forge": {"command": "uvx", "args": ["cv-forge-mcp"]}}}Try it
→Generate a new CV template for me to fill out.
→I have pasted my work history here; please use the generate_cv tool to structure it and then create a PDF version.
→Update my CV with the new project details I just provided and generate a DOCX file.
→Create a professional CV based on my LinkedIn profile text and provide the link to the visual editor for final tweaks.