Metadata-Version: 2.4
Name: resume-forge-mcp
Version: 0.4.0
Summary: MCP server for intelligent LaTeX resume generation — browse 350+ Overleaf templates, auto-compile with pdflatex/xelatex/lualatex, tailor to job descriptions, ATS scoring, and visual preview.
Project-URL: Homepage, https://github.com/jitendrasinghsankhwar/resume-forge-mcp
Project-URL: Repository, https://github.com/jitendrasinghsankhwar/resume-forge-mcp
Project-URL: Issues, https://github.com/jitendrasinghsankhwar/resume-forge-mcp/issues
Author: Jitendra Singh Sankhwar, Danny Liu
License-Expression: MIT
License-File: LICENSE
Keywords: ai,claude,cv,latex,mcp,overleaf,pdf,resume
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Requires-Python: >=3.11
Requires-Dist: jinja2>=3.1.0
Requires-Dist: mcp>=1.0.0
Requires-Dist: pydantic>=2.0.0
Provides-Extra: all
Requires-Dist: pymupdf>=1.24.0; extra == 'all'
Requires-Dist: python-docx>=1.0.0; extra == 'all'
Provides-Extra: docx
Requires-Dist: python-docx>=1.0.0; extra == 'docx'
Provides-Extra: pdf
Requires-Dist: pymupdf>=1.24.0; extra == 'pdf'
Provides-Extra: preview
Requires-Dist: pymupdf>=1.24.0; extra == 'preview'
Description-Content-Type: text/markdown

# Resume Forge MCP

An MCP (Model Context Protocol) server for intelligent LaTeX resume generation with multiple template styles, quality scoring, and job description tailoring.

## Features

- **3 built-in templates**: Modern (color accents), Classic (traditional), Minimal (no-frills)
- **Overleaf integration**: Browse and fetch 350+ templates dynamically
- **Multi-format import**: Import resume data from .tex, .pdf, or .docx files
- **Quality scoring**: Bullet analysis, ATS compatibility, keyword matching
- **Job tailoring**: Auto-select and rank content based on job descriptions
- **Visual preview**: Compile to PDF and preview as images directly in your AI assistant

## Installation

```bash
uvx resume-forge-mcp
```

With PDF and DOCX import support:

```bash
uvx --with pymupdf --with python-docx resume-forge-mcp
```

## Configuration

Add to your AI assistant's MCP config:

```json
{
  "mcpServers": {
    "resume-forge": {
      "command": "uvx",
      "args": ["resume-forge-mcp"],
      "env": {
        "RESUME_DATA_DIR": "/path/to/data",
        "RESUME_TEMPLATE_DIR": "/path/to/templates",
        "RESUME_OUTPUT_DIR": "/path/to/output"
      }
    }
  }
}
```

### Environment Variables

| Variable | Default | Purpose |
|----------|---------|---------|
| `RESUME_DATA_DIR` | `~/.resume-forge/data` | Resume data JSON |
| `RESUME_TEMPLATE_DIR` | `~/.resume-forge/templates` | Fetched Overleaf templates |
| `RESUME_OUTPUT_DIR` | `~/.resume-forge/output` | Generated .tex and .pdf files |

All env vars are optional — defaults to `~/.resume-forge/` subdirectories.

## Prerequisites

For PDF compilation, install LaTeX:

- **macOS**: `brew install --cask mactex`
- **Ubuntu**: `sudo apt install texlive-latex-base texlive-latex-extra texlive-fonts-extra`
- **Windows**: Install [MiKTeX](https://miktex.org/)

## Tools (11)

### Templates
| Tool | Description |
|------|-------------|
| `list_templates` | List built-in templates (modern/classic/minimal) + Overleaf info |
| `browse_overleaf_templates` | Browse 350+ Overleaf templates by category |
| `fetch_overleaf_template` | Download an Overleaf template source |

### Data Management
| Tool | Description |
|------|-------------|
| `import_resume` | Import from .tex, .pdf, or .docx into structured data |
| `get_resume_data` | Get the master resume data pool |
| `update_resume_data` | Add, edit, or remove entries in any section |

### Generation & Compilation
| Tool | Description |
|------|-------------|
| `generate_resume` | Render data to .tex using selected template |
| `compile_and_preview` | Compile to PDF and return preview image |
| `generate_tailored_resume` | Parse JD, select content, generate tailored resume |

### Analysis & Config
| Tool | Description |
|------|-------------|
| `score_resume_quality` | Score bullets, ATS compatibility, keyword matching |
| `get_config` | Show configuration and tool availability |

## Usage

```
> List available templates
→ modern, classic, minimal + Overleaf gallery

> Import my resume from resume.tex
→ Extracts contact, education, experience, skills into structured data

> Generate my resume using the classic template
→ Creates .tex file using classic layout

> Score my resume against keywords: Python, AWS, Kubernetes
→ Returns quality scores, ATS report, keyword match percentage

> Generate a tailored resume for this job description: [paste JD]
→ Auto-selects relevant experience, generates and compiles
```

## License

MIT
