tuneit-mcp

TuneIt MCP Server to expose tools that format, save, and integrate with OpenAI to automate resume tailoring actions.

Features

This MCP server provides the following tools:

• format_to_markdown: Formats a job description into well-structured markdown with proper headers and sections

• tailor_resume: Tailors a resume to match a specific job description using AI

• save_job: Saves a job description to the output/jobs/ folder

• save_tailored_resume: Saves a tailored resume to the output/tailored_resumes/ folder

Prerequisites

• Python 3.10 or higher

• OpenAI API key

Installation

1. Clone the repository:

   git clone https://github.com/mcuellar/tuneit-mcp.git
   cd tuneit-mcp

2. Create and activate a virtual environment:

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

3. Install dependencies:

   pip install -r requirements.txt

4. Set up environment variables:

   # Create a .env file or export directly
   export OPENAI_API_KEY=your_openai_api_key_here
   
   # Optional: customize output directory (defaults to ./output)
   export OUTPUT_DIR=./output

Usage

Running the Server

Start the MCP server:

python server.py

Configuring with Claude Desktop

Add the following to your Claude Desktop configuration file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "tuneit-mcp": {
      "command": "/path/to/your/.venv/bin/python",
      "args": ["/path/to/tuneit-mcp/server.py"],
      "env": {
        "OPENAI_API_KEY": "your_openai_api_key_here"
      }
    }
  }
}

Tool Descriptions

format_to_markdown

Formats a raw job description into clean, well-structured markdown with proper headers including job title, company, responsibilities, requirements, and more.

Parameters:

• job_description (string): The raw job description text to format

tailor_resume

Tailors an existing resume to better match a specific job description while maintaining truthfulness and professional formatting.

Parameters:

• base_resume (string): The original resume text to tailor

• job_description (string): The job description to tailor the resume for

save_job

Saves a job description (preferably already formatted in markdown) to the jobs folder.

Parameters:

• job_content (string): The job description content to save

• filename (string): The filename to save as (without extension)

save_tailored_resume

Saves a tailored resume to the tailored resumes folder.

Parameters:

• resume_content (string): The tailored resume content to save

• filename (string): The filename to save as (without extension)

Output Directory Structure

output/
├── jobs/
│   ├── software_engineer_acme.md
│   └── data_scientist_techcorp.md
└── tailored_resumes/
    ├── software_engineer_acme_resume.md
    └── data_scientist_techcorp_resume.md

Environment Variables

License

MIT