cd job-matcher-mcp

pip install -r requirements.txt

export USE_MOCK_DATA=true
python mcp_server.py

=== Testing search_jobs ===
{
"success": true,
"job_listings": [
{
"id": "mock_1",
"title": "Senior Product Manager",
"company": "TechCorp Inc",
"location": "San Francisco, CA",
...
}
],
...
}

=== Testing customize_resume ===
{
"success": true,
"customized_resume": "# John Doe...",
...
}

git clone https://github.com/yourusername/job-matcher-mcp.git
cd job-matcher-mcp

# macOS/Linux
python3 -m venv venv
source venv/bin/activate

# Windows
python -m venv venv
.\venv\Scripts\Activate.ps1

pip install -r requirements.txt

cp .env.example .env

ADZUNA_APP_ID=ihre_tatsaechliche_app_id
ADZUNA_APP_KEY=ihr_tatsaechlicher_app_key
ANTHROPIC_API_KEY=sk-ant-ihr_tatsaechlicher_api_key
USE_MOCK_DATA=false
LOG_LEVEL=INFO

# macOS/Linux
export $(grep -v '^#' .env | xargs)

# Windows PowerShell
Get-Content .env | ForEach-Object {
    $name, $value = $_.Split('=')
    if ($name) { Set-Item -Path env:\$name -Value $value }
}

python mcp_server.py

# Nach Jobs suchen
curl -X POST http://localhost:8000/tools/search_jobs \
-H "Content-Type: application/json" \
-d '{
"role": "Product Manager",
"location": "San Francisco, CA",
"experience_years": 5,
"max_results": 10
}'

# Lebenslauf anpassen
curl -X POST http://localhost:8000/tools/customize_resume \
-H "Content-Type: application/json" \
-d '{
"base_resume": "...",
"job_description": "...",
"template": "modern"
}'

from mcp_server import JobMatcherMCPServer

server = JobMatcherMCPServer()

# Jobs suchen
jobs = server.search_jobs(
role="Product Manager",
location="San Francisco, CA",
experience_years=5,
max_results=10
)
print(jobs)

# Lebenslauf anpassen
resume = server.customize_resume(
base_resume="Ihr Lebenslauftext hier...",
job_description="Stellenbeschreibung hier...",
template="modern"
)
print(resume)

{
"role": "Product Manager",              // Erforderlich: Jobtitel
"location": "San Francisco, CA",        // Erforderlich: Geografischer Standort
"experience_years": 5,                  // Erforderlich: Berufserfahrung in Jahren
"max_results": 10,                      // Optional: Ergebnislimit (Standard: 10)
"use_mock_data": false                  // Optional: Mock-Daten verwenden (Standard: false)
}

{
"success": true,
"job_listings": [
{
"id": "12345",
"title": "Senior Product Manager",
"company": "TechCorp",
"location": "San Francisco, CA",
"link": "https://...",
"salary_min": 120000,
"salary_max": 160000,
"posted_date": "2026-08-17T10:00:00Z",
"description_snippet": "Wir suchen..."
}
],
"total_found": 123,
"search_time_ms": 1234,
"error": null
}

jobs = server.search_jobs(
role="Product Manager",
location="Remote",
experience_years=3,
max_results=5
)

{
"base_resume": "# Jane Doe...",                     // Erforderlich: Ihr Lebenslauftext
"job_description": "Wir suchen...",         // Erforderlich: Stellenausschreibung
"template": "modern",                               // Optional: modern|classic|minimal
"use_mock_data": false                              // Optional: Mock-Daten verwenden
}

{
"success": true,
"customized_resume": "# Jane Doe...",
"match_analysis": {
"skills_match_percentage": 82,
"matched_skills": ["Produktmanagement", "Führung"],".$&!"missing_skills": ["Maschinelles Lernen", "Cloud"],
"suggestions": ["Fügen Sie ML-Erfahrung hinzu, falls zutreffend"],
"keywords_added": ["Datengetrieben", "übergeriflich"]
},
"eneration_time_ms": 2345,
"error": null
}

customized = server.customize_resume(
base_resume=open("resume.txt").read(),
job_description=open("job_posting.txt").read(),
template="modern"\)```
d

***

## 🏗️ Architektur

***

## 🔍 Fehlerbehebung

### Problem: `ModuleNotFoundError: No module named 'anthropic'` n**Lösung:** Ahängigkeiten installieren
\`bash
pip install -r requirements.txt

d
### Problem: `No jobs found` n**Lösung:** Proieren Sie eine andere Rolle/einen anderen Standort oder erhöhen Sie max_results
\`python
# Breitere Suche versuchen
jobs = server.search_jobs(
role="Manger",  # Allgemeinerer Begriff
location="New York, NY",
experience_years=5,
max_results=50
)

d
### Problem: `Rate limit exceeded` n**Lösung:** Der kostenlose Adzuna-Tarif hat Limits. Implementieren Sie Caching:
\`python
# Suchergebnisse zwischenspeichern
cached_jobs = {}
key = f"{role}_{location}_{experience_years}"
if key not in cacked_jobs:
    cacked_jobs[key] = server.search_jobs(...)

d
### Auf Railway deployen
\`bash
# 1. Railwy-Konto unter https://railway.app erstellen
# 2. Git-Repository verbinden
# 3. Umgebungsvariablen im Railwy-Dashoard hinzufügen