Resume Gap Analyzer

The Resume Gap Analyzer MCP Server analyzes resumes against job descriptions to identify gaps, missing keywords, and improvement opportunities using GPT-4o-mini. It helps you optimize resumes for ATS, highlight strengths, and provide prioritized, actionable feedback to boost alignment with target roles.

How to use

You interact with this MCP server through an MCP client. After you configure the server, you send a request to analyze a resume against a job description. The server returns a structured analysis that highlights gaps, missing keywords, strengths to emphasize, and concrete quick wins you can implement immediately. Use this flow to iteratively improve resumes for multiple job descriptions.

How to install

Prerequisites: Python 3.10 or newer and an OpenAI API key.

Step 1: Clone the project and enter the directory.

git clone <repository-url>
cd gapsinmyresume

Step 2: Create and activate a virtual environment.

python3 -m venv .venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate

Step 3: Install dependencies.

pip install -r requirements.txt

Step 4: Set your OpenAI API key.

# Copy the example env file
cp .env.example .env

# Edit .env and add your actual API key
# OPENAI_API_KEY=sk-your-actual-key-here

Configuration for Claude Desktop

To use this MCP server with Claude Desktop, add it to your config file. Replace placeholders with your actual paths.

{
  "mcpServers": {
    "resume-gap-analyzer": {
      "command": "/absolute/path/to/gapsinmyresume/.venv/bin/python",
      "args": ["/absolute/path/to/gapsinmyresume/server.py"]
    }
  }
}

Usage notes

Option 1: Via Claude Desktop (Recommended) After configuring, simply ask Claude in the desktop app to analyze a resume against a job description. Claude will invoke the analyze_resume_gaps tool automatically.

Option 2: Direct CLI Testing You can test without Claude Desktop by running the test script. Activate the virtual environment and run the test to analyze a sample resume against a sample job description.

Option 3: MCP Server Directly Start the MCP server for debugging or integration. Activate the virtual environment and run the server to listen for MCP messages.

Available tools

analyze_resume_gaps

Analyzes a resume against a job description to identify gaps, missing keywords, suggested improvements, and strengths to highlight. Returns a structured report with gaps, missing keywords, experience notes, strengths to emphasize, and quick win recommendations.