简历优化服务器

# Clone the repository
git clone https://github.com/Tzippykaplan/job-search-mcp/
cd job-search-mcp

# Create and activate virtual environment
python -m venv .venv

# Windows
.venv\Scripts\activate

# Mac/Linux
source .venv/bin/activate

# Install the package
pip install -e .

# For development (includes pytest, black, ruff)
pip install -e ".[dev]"

GEMINI_API_KEY=your_gemini_api_key_here
LOG_LEVEL=INFO  # Optional: DEBUG, INFO, WARNING, ERROR

{
  "mcpServers": {
    "job-search-mcp": {
      "command": "C:/Users/YourName/path/to/job-search-mcp/.venv/Scripts/python.exe",
      "args": ["-u", "C:/Users/YourName/path/to/job-search-mcp/src/job_mcp/server.py"],
      "cwd": "C:/Users/YourName/path/to/job-search-mcp",
      "env": {
        "GEMINI_API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}

codex mcp add job-search-mcp -- \
  /path/to/.venv/Scripts/python.exe \
  -u /path/to/src/job_mcp/server.py

"I found this job: https://www.example.com/job-posting
Here's my resume: [paste or attach file]
Can you tailor my resume for this position?"

"What are my chances for this job?"
→ Calls match_resume_to_job, returns score and gaps

"Extract the requirements from this job posting"
→ Calls extract_job_requirements, returns structured data

"Rewrite my resume for this specific role"
→ Calls rewrite_resume_for_job, returns optimized version

extract_job_requirements
    ↓
match_resume_to_job
    ↓
rewrite_resume_for_job
    ↓
export_resume_docx

src/job_mcp/
├── server.py                          # MCP server entry point
├── config.py                          # Configuration (model, limits, paths)
├── exceptions.py                      # Custom exception hierarchy
├── tools/                             # MCP tool wrappers
│   ├── extract_job_requirements_tool.py
│   ├── match_resume_to_job_tool.py
│   ├── rewrite_resume_for_job_tool.py
│   └── export_resume_docx_tool.py
├── services/                          # Business logic layer
│   ├── extract_job_requirements_service.py
│   ├── match_resume_to_job_service.py
│   ├── rewrite_resume_for_job_service.py
│   └── export_resume_docx_service.py
├── adapters/                          # External integrations
│   ├── gemini_client.py              # Gemini AI client
│   └── job_page_fetcher.py           # Job scraping (httpx + BeautifulSoup)
├── utils/                             # Shared utilities
│   ├── gemini_helpers.py             # JSON parsing, fence stripping
│   ├── read_resume.py                # Resume file readers (.txt, .md, .docx)
│   ├── export_resume_docx.py         # DOCX generation
│   ├── validation.py                 # Input validation
│   └── logger.py                     # Logging 
└── prompts/                           # LLM prompt templates (external files)
    ├── system_prompt.txt              # MCP agent system instructions
    ├── extract_job_requirements_prompt.txt   # Job parsing prompt
    ├── match_resume_prompt.txt               # Resume matching prompt
    └── rewrite_resume_prompt.txt             # Resume rewriting prompt

{
  "source": "job_url"|"job_text",
  "job_url": "https://..."|null,
  "extracted": {
    "title": "Senior Python Engineer"|null,
    "company": "TechCorp Inc."|null,
    "location": "Remote"|null,
    "years_experience": ["5+ years Python", "3+ years React"],
    "must_have_tech": ["Python", "React", "PostgreSQL"],
    "nice_to_have_tech": ["Docker", "Kubernetes"],
    "soft_skills": ["Communication", "Team leadership"],
    "notes": ["Remote with quarterly onsite meetings"]
  }
}

{
  "source": "job_url",
  "job_url": "https://...",
  "error": "blocked_by_site",
  "message": "Site blocked scraping (403) or empty page. Paste the job content into job_text instead."
}

{
  "score": 78,
  "matched_keywords": ["Python", "React", "AWS"],
  "missing_keywords": ["PostgreSQL", "Kubernetes"],
  "strengths": [
    "8 years Python experience (exceeds 5yr requirement)",
    "Led team of 6 engineers"
  ],
  "gaps": [
    "No PostgreSQL experience mentioned",
    "Limited Kubernetes background"
  ]
}

{
  "sections": {
    "Summary": "Senior Full Stack Engineer with 8+ years...",
    "Skills": "Languages: Python, JavaScript, TypeScript\nFrameworks: React, Django...",
    "Experience": "Senior Software Engineer | TechCorp\n2020-Present\n• Developed...",
    "Projects": "E-commerce Platform\nPython, React, PostgreSQL\n• Built...",
    "Education": "B.S. Computer Science | MIT | 2015"
  },
  "rewritten_resume": "Summary\n\nSenior Full Stack Engineer with 8+ years...\n\nSkills\n...",
  "changes": [
    "Moved React and TypeScript to top of Skills section",
    "Emphasized Python projects in Experience section",
    "Rephrased team collaboration points to highlight leadership"
  ],
  "warnings": [
    "No Kubernetes experience - this is a must-have requirement",
    "Limited PostgreSQL background - consider adding database coursework"
  ]
}

{
  "saved_path": "output_resumes/resume_2026-01-09_143052.docx",
  "output_dir": "output_resumes",
  "add_timestamp": true
}

pytest                    # Run all tests
pytest -v                 # Verbose output
pytest tests/unit/        # Specific suite
pytest --cov=src/job_mcp  # With coverage report

pytest                    # Test runner
pytest-cov                # Coverage reporting

# Test server manually
python src/job_mcp/server.py

# Should show:
MCP Server starting...