job-mcp

Ein FastMCP-Server (stdio-Transport) mit:

• Ressource cv://profile — dein CV/Lebenslauf als JSON, damit der LLM-Client ihn lesen kann.

• Tool send_email — sendet eine E-Mail über SMTP mit Red Mail.

Workflow: Du gibst dem MCP-Client eine Stellenausschreibung + die E-Mail-Adresse des Recruiters im Chat → der Client liest cv://profile → entwirft eine maßgeschneiderte Bewerbungs-E-Mail → ruft send_email auf, um sie zu senden.

1. Installieren

cd job-mcp
python -m venv .venv
source .venv/bin/activate   # Windows: .venv\Scripts\activate
pip install -e .

Related MCP server: MCP Server

2. SMTP-Zugangsdaten konfigurieren

cp .env.example .env

Bearbeite .env mit deinen SMTP-Zugangsdaten. Für Gmail verwende ein App-Passwort (nicht dein normales Anmelde-Passwort), und aktiviere zuerst die zweistufige Verifizierung.

3. Lebenslauf ausfüllen

Bearbeite src/job_mcp/data/cv.json mit deinen echten Daten (Kontaktinformationen, Fähigkeiten, Berufserfahrung, Ausbildung, Projekte, Zertifizierungen). Die Ressource liest diese Datei einfach unverändert.

4. Server eigenständig ausführen (Plausibilitätsprüfung)

python -m job_mcp.server

Er wartet dann auf MCP-JSON-RPC-Nachrichten auf stdin/stdout (das ist normal — er soll von einem MCP-Client gestartet werden, nicht interaktiv verwendet werden).

Du kannst es auch mit dem MCP-Entwicklungsinspektor untersuchen:

mcp dev src/job_mcp/server.py

5. Mit einem MCP-Client verbinden

Beispielkonfiguration für einen Client, der Server über stdio startet (z.B. die claude_desktop_config.json von Claude Desktop):

{
  "mcpServers": {
    "job-mcp": {
      "command": "/absolute/path/to/job-mcp/.venv/bin/python",
      "args": ["-m", "job_mcp.server"],
      "env": {
        "SMTP_HOST": "smtp.gmail.com",
        "SMTP_PORT": "587",
        "SMTP_USERNAME": "you@gmail.com",
        "SMTP_PASSWORD": "your-app-password",
        "SMTP_SENDER_EMAIL": "you@gmail.com",
        "SMTP_SENDER_NAME": "Your Name"
      }
    }
  }
}

(Du kannst die Zugangsdaten hier in env statt in .env angeben — beides funktioniert, da config.py in jedem Fall aus os.environ liest.)

6. Verwenden

Füge im Client etwa Folgendes ein:

Hier ist eine Stellenausschreibung und die E-Mail-Adresse des Recruiters. Lies meine CV-Ressource, entwirf dann und sende eine maßgeschneiderte Bewerbungs-E-Mail.

Stellenausschreibung: <Text einfügen> Recruiter-E-Mail: hr@company.com

Der Client sollte cv://profile aufrufen, die E-Mail unter Verwendung beider Kontextteile entwerfen und send_email(to=..., subject=..., body_html=..., body_text=...) aufrufen.

Notizen / spätere Härtungsmaßnahmen

• send_email hat derzeit keinen Bestätigungsschritt in den Server selbst eingebaut — wenn du serverseitig (nicht nur clientseitig) eine „Prüfung vor dem Senden“ als Schutzmaßnahme erzwingen möchtest, füge einen zweistufigen Ablauf hinzu (z.B. ein draft_email-Tool, das eine Vorschau + eine id zurückgibt, und ein confirm_send-Tool, das die E-Mail tatsächlich sendet).

• Erwäge Ratenbegrenzung oder das Protokollieren gesendeter E-Mails, um versehentliche Doppelsendungen zu vermeiden.

• cv.json wird bei jedem Ressourcenaufruf neu gelesen, sodass du es bearbeiten kannst, ohne den Server neu zu starten.