cv-forge-mcp

README.md

# CV Forge MCP Server

[![PyPI](https://img.shields.io/pypi/v/cv-forge-mcp)](https://pypi.org/project/cv-forge-mcp/)
[![License](https://img.shields.io/badge/license-MIT-brightgreen)](LICENSE)

MCP (Model Context Protocol) server for [CV Forge](https://github.com/Guid-Lab/cv-forge). Lets AI assistants generate professional CVs as PDF/DOCX from conversation data.

## How It Works

1. You describe your experience to the AI (or paste LinkedIn profile text)
2. AI fills in the CV template using the `generate_cv` tool
3. AI calls `generate_pdf` or `generate_docx` to produce the document
4. 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

- [Docker](https://docs.docker.com/get-docker/)

## Quick Start

### Claude Code

```bash
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):

```json
{
  "mcpServers": {
    "cv-forge": {
      "command": "uvx",
      "args": ["cv-forge-mcp"]
    }
  }
}
```

### Manual install (alternative)

```bash
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`](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

Deploy Server

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

TDQS

A4.3/5.0

Scored 2026-04-13 02:50 across 4 tools

Disambiguation5/5

Each tool has a distinct, non-overlapping purpose: setup initializes the backend, generate_cv creates a template, generate_docx produces a DOCX file, and generate_pdf produces a PDF file. The descriptions clearly differentiate their roles in the CV creation workflow, with no ambiguity about which tool to use for each step.

Naming Consistency5/5

All tool names follow a consistent verb_noun pattern with snake_case: cv_forge_setup, generate_cv, generate_docx, and generate_pdf. The naming is predictable and readable, making it easy for an agent to understand the action each tool performs based on its name alone.

Tool Count5/5

With 4 tools, this server is well-scoped for its purpose of CV generation and formatting. Each tool earns its place by covering essential steps: setup, template creation, and output generation in two common formats. The count is neither too thin nor excessive for the domain.

Completeness4/5

The tool set covers the core CV creation workflow from setup to final output, with no obvious dead ends. A minor gap exists in the lack of tools for updating or deleting CV data, but agents can work around this by regenerating from scratch, and the domain focus on generation rather than management makes this acceptable.

Maintenance

ActivityNo data

ResponsivenessNo issues

Resources

Need Help?

Related Servers