CV Resume Builder MCP

AI-powered CV and resume builder using Model Context Protocol (MCP)

Automatically generate and update your CV/resume from git commits, Jira tickets, Credly certifications, and LinkedIn. Built for developers who want their CV to stay current without manual updates.

Features

• Git commits - Track your code contributions automatically
• Jira tickets - Pull completed projects and tasks (requires testing)
• Credly badges - Sync certifications and achievements
• LinkedIn profile - Not implemented yet (authentication required)
• PDF parsing - Extract content from existing CVs
• Enhanced CV generation - Combine all data sources
• LaTeX support - Generate professional CVs

Quick Start

Prerequisites

• Python 3.10+
• uv installed (for uvx): curl -LsSf https://astral.sh/uv/install.sh | sh
• An MCP-compatible AI assistant (Claude Desktop, Kiro, etc.)

Installation

Using uvx (recommended - no installation needed!):

Just configure your MCP client and uvx handles the rest.

Or install with pip:

pip install cv-resume-builder-mcp

Configuration

For Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "cv-resume-builder": {
      "command": "uvx",
      "args": ["cv-resume-builder-mcp"],
      "env": {
        "AUTHOR_NAME": "your-git-username",
        "REPOS": "default:/absolute/path/to/your-repo"
      }
    }
  }
}

For multiple repositories: Change REPOS to: "CompanyA:/path1,CompanyB:/path2,Personal:/path3"

For Kiro IDE

Edit ~/.kiro/settings/mcp.json:

{
  "mcpServers": {
    "cv-resume-builder": {
      "command": "uvx",
      "args": ["cv-resume-builder-mcp"],
      "env": {
        "AUTHOR_NAME": "your-git-username",
        "REPOS": "default:/absolute/path/to/your-repo"
      }
    }
  }
}

For multiple repositories: Change REPOS to: "CompanyA:/path1,CompanyB:/path2,Personal:/path3"

Important: Use absolute paths (no ~). Get it with pwd in your repo directory.

Restart Your AI Assistant

After configuration, restart Claude Desktop or Kiro to load the MCP server.

Test It

"List available MCP tools"

You should see tools like get_git_log, read_cv, parse_cv_pdf, etc.

Usage Examples

"Get my git commits from the last 6 months and suggest CV updates"

With multiple repositories:

"List all my configured repositories"
"Get my commits from CompanyA for the last 3 months"
"Show me all my work across all repositories in the last year"

Parse existing CV

"Parse my CV at ~/Documents/resume.pdf"

Generate enhanced CV

"Generate an enhanced CV using my existing resume.pdf and recent work from the last 3 months"

Get certifications

"Get my Credly badges and add them to my CV"

Analyze commit impact (NEW!)

"Analyze my commits from the last month and show me what I actually built"
"Get detailed code changes for commit abc123 to understand the impact"
"Show me the stats for my recent commits to highlight achievements"

Optional Integrations

Add these to your MCP configuration's env section:

Jira ( Requires Testing)

"JIRA_URL": "https://your-company.atlassian.net",
"JIRA_EMAIL": "your-email@example.com",
"JIRA_API_TOKEN": "your-api-token",
"JIRA_USER": "your-email@example.com"

Get API token: https://id.atlassian.com/manage-profile/security/api-tokens

Note: Jira integration is functional but requires more testing across different Jira configurations. Please report any issues!

Credly ( Fully Tested)

"CREDLY_USER_ID": "your-credly-username"

Find your username in your Credly profile URL: https://www.credly.com/users/YOUR-USERNAME

LinkedIn ( Not Implemented)

"LINKEDIN_PROFILE_URL": "https://www.linkedin.com/in/yourprofile"

Note: LinkedIn integration is not yet implemented due to authentication requirements. The tool currently only returns your profile URL. For now, manually copy your LinkedIn achievements to wins.md file. Contributions welcome!

CV Formatting

"MAX_BULLETS_PER_EXPERIENCE": "5"

Available Tools

Project Structure

cv-resume-builder-mcp/
 src/cv_resume_builder_mcp/
    __init__.py
    server.py          # Main MCP server
 tests/
    test_server.py     # Unit tests
 pyproject.toml         # Package configuration
 requirements.txt       # Dependencies
 .env.example           # Configuration template
 cv.tex                 # LaTeX CV template
 wins.md                # …