winning-cv-mcp
Uses OpenAI API for AI-powered job matching, job analysis, and tailored CV generation.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
WinningCV MCP Server
An MCP (Model Context Protocol) server for AI-powered job matching and CV generation. Search jobs on LinkedIn and Seek, match them against your CV, get detailed fit analysis, and generate tailored CVs.
Features
🔍 search_jobs - Search for jobs on LinkedIn and/or Seek
📊 match_jobs - AI-powered CV matching with scoring (1-10)
🎯 analyze_job - Deep-dive job analysis with fit assessment, strengths, gaps, red flags, and cover letter angles
📝 generate_cv - Generate tailored CVs optimized for specific jobs
Related MCP server: MCP智能简历投递助手
Installation
npm install
npm run buildConfiguration
Copy .env.example to .env and configure:
cp .env.example .envEnvironment Variables
Variable | Description | Default |
| OpenAI API key (or "dummy" for proxies) | Required |
| OpenAI-compatible API endpoint | OpenAI default |
| Model to use for AI features | gpt-4o-mini |
Using with GitHub Copilot Proxy
export OPENAI_API_KEY=dummy
export OPENAI_BASE_URL=http://localhost:14141/v1
export OPENAI_MODEL=gpt-4oUsage
Running the Server
node dist/index.jsMCP Integration
Add to your MCP client configuration:
{
"mcpServers": {
"winning-cv": {
"command": "node",
"args": ["/path/to/winning-cv-mcp/dist/index.js"],
"env": {
"OPENAI_API_KEY": "your-key",
"OPENAI_MODEL": "gpt-4o"
}
}
}
}Tools
search_jobs
Search for jobs on LinkedIn and/or Seek.
Input:
{
"keywords": "Digital Transformation Manager",
"location": "Melbourne, Australia",
"sources": ["linkedin", "seek"],
"days_old": 7
}Output: List of jobs with title, company, location, URL, salary, and posted date.
match_jobs
Score how well your CV matches job postings.
Input:
{
"cv_path": "/path/to/your-cv.pdf",
"job_urls": [
"https://www.seek.com.au/job/123456",
"https://www.linkedin.com/jobs/view/789012"
],
"threshold": 7
}Output: Jobs meeting the threshold with scores, strengths, and gaps.
analyze_job
Get detailed analysis of a job against your CV.
Input:
{
"cv_path": "/path/to/your-cv.pdf",
"job_url": "https://www.seek.com.au/job/123456"
}Output:
Fit assessment (score 1-10, recommendation: strong_apply/apply/consider/skip)
Strengths with categories
Gaps with severity (critical/moderate/minor) and mitigation suggestions
Red flags
Cover letter angles with talking points
Key requirements checklist (met/unmet with evidence)
generate_cv
Generate a tailored CV for a specific job.
Input:
{
"cv_path": "/path/to/your-cv.pdf",
"job_url": "https://www.seek.com.au/job/123456",
"output_format": "markdown",
"tone": "professional"
}Options:
output_format: markdown, plain_text, or structured (JSON)tone: professional, creative, technical, or executivefocus_areas: Optional array of areas to emphasize
Output: Tailored CV content with tailoring notes (keywords emphasized, skills highlighted, experience reframed).
Supported CV Formats
PDF
DOCX
TXT
Markdown (.md)
Dependencies
Node.js 18+
Playwright (for web scraping)
Installing Playwright Browsers
npx playwright install chromiumDevelopment
# Build
npm run build
# Watch mode
npm run dev
# Test a tool
echo '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' | node dist/index.jsLicense
MIT
Author
Jack Hui (https://jackhui.com.au)
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
A job-search companion: tailor your CV to a role, score fit, fix ATS issues. Also via MCP.
Auto-apply to jobs: matches your CV, tailors a fresh CV per posting, and applies for you.
Litjob AI job application assistant: job matches, tailored CVs and cover letters. You submit.
Find jobs and apply with AI: search jobs, set up Auto Apply from your resume and track applications.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceHelps users find suitable LinkedIn job opportunities by automatically scraping listings, analyzing compatibility with user profiles using AI, and sending custom match reports via email.1-
- FlicenseNot gradedqualityDmaintenanceEnables AI-driven job application automation for LinkedIn and SEEK platforms with intelligent cover letter generation, automated application submission, and application tracking management. Supports anti-detection measures and complies with platform usage policies for safe job hunting automation.-
- AlicenseNot gradedqualityDmaintenanceProcesses and manages applicant resumes, facilitates job searches, generates job-specific resumes, and creates tailored cover letters.1MIT
- AlicenseNot gradedqualityDmaintenanceAutomates job application tracking and resume/cover letter generation using AI, integrating with Google Drive, Notion, and Gmail.1MIT