ResumePilot MCP

Ein skalierbarer Universal Job Application MCP-Server für Claude Desktop.

Du gibst Claude einen Master-Lebenslauf. ResumePilot parst ihn, erstellt ein wiederverwendbares Profil, analysiert Stellenbeschreibungen im Vergleich dazu, berechnet stellenspezifische ATS-/Match-Scores, generiert maßgeschneiderte Lebensläufe, die niemals Informationen erfinden, verfolgt jede Bewerbung in einer lokalen Datenbank und erstellt einen abschließenden PDF-Bericht mit Tracking-Seiten pro Bewerbung.

Phase 1 (diese Version) ist eine vollständige, getestete, vollständig lokale Grundlage. Du fügst eine Stellenbeschreibung ein und die gesamte Pipeline läuft Ende-zu-Ende – keine externe Job-Website erforderlich. Globale Jobsuche, Bewerbungsautomatisierung und E-Mail-Tracking sind spätere Phasen, die in dieselbe Adapterarchitektur passen. Siehe docs/ARCHITECTURE.md.

Was es nicht tun wird

• ❌ Erfindet niemals Fähigkeiten, Erfahrungen, Ausbildung, Zertifizierungen oder Kennzahlen.

• ❌ Speichert niemals LinkedIn-/Naukri-/andere Passwörter oder OTPs.

• ❌ Umgeht niemals CAPTCHA, 2FA, Bot-Schutz oder Authentifizierung.

• ❌ Übermittelt niemals automatisch an beliebige Websites (Phase 1 bereitet vor; du übermittelst).

Wenn eine erforderliche Fähigkeit nicht aus deinem Material verifiziert werden kann, meldet ResumePilot "Erforderliche Fähigkeit nicht aus dem Profil des Benutzers verifiziert." – es wird sie nicht hinzufügen.

Related MCP server: resume-tailor-mcp-server

Anforderungen

• Node.js ≥ 18.18

• Claude Desktop (für die MCP-Nutzung)

Installation und Build

git clone <your-fork-url> resumepilot-mcp
cd resumepilot-mcp
npm install
npm run build
cp .env.example .env    # optional — sensible defaults otherwise

Teste es ohne Claude (Offline-Demo)

Führt die gesamte Pipeline über dieselben Tools aus, die Claude aufruft, in einem temporären Ordner:

npm run demo

Du siehst Original-→-optimierte ATS-Scores, einen generierten PDF-Bericht und HTML-Tracking-Seiten.

Führe die Tests aus

npm test

40 Tests decken Parsing, Bewertung, die „Niemals erfinden“-Garantie, Optimierung, Tracking, Berichterstellung und die End-to-End-Tool-Pipeline ab.

Download (Claude Desktop-Erweiterung)

Hole dir die sofort installierbare Erweiterung von der Releases-Seite:

Möchtest du nur die Erweiterung? Lade resumepilot.mcpb herunter, öffne Claude Desktop → Einstellungen → Erweiterungen, ziehe die Datei hinein, lege deinen Datenordner fest und schalte sie ein.

Installation in Claude Desktop

Zwei Optionen – vollständige Anleitung in docs/INSTALL.md:

• Ein-Klick-Desktop-Erweiterung: npm run bundle erzeugt resumepilot.mcpb; ziehe sie in Claude Desktop → Einstellungen → Erweiterungen, lege deinen Datenordner fest und schalte sie ein. (Das Bundle enthält ein natives SQLite-Binärprogramm, also baue es auf deinem eigenen Betriebssystem – ein Befehl – für macOS/Windows.)

• Manuelle MCP-Konfiguration: Aus dem Quellcode bauen und einen mcpServers-Eintrag hinzufügen.

Verbindung zu Claude Desktop herstellen (manuelle Konfiguration)

1. Build: npm run build (erzeugt dist/src/index.js).

2. Öffne deine Claude-Desktop-Konfigurationsdatei:

   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

   • Windows: %APPDATA%\Claude\claude_desktop_config.json

3. Füge den Server hinzu (siehe docs/claude_desktop_config.example.json) und verwende absolute Pfade:

   {
     "mcpServers": {
       "resumepilot": {
         "command": "node",
         "args": ["/ABSOLUTE/PATH/TO/resumepilot-mcp/dist/src/index.js"],
         "env": {
           "RESUMEPILOT_DATA_DIR": "/ABSOLUTE/PATH/TO/your-private-data",
           "ATS_TARGET_SCORE": "90"
         }
       }
     }
   }

4. Beende Claude Desktop vollständig und öffne es erneut. Die Tools von ResumePilot erscheinen im Tools-Menü (🔌).

Verwendung

Sag einfach:

„Starte meinen ResumePilot-Bewerbungsprozess.“

Claude versteht den Arbeitsablauf und wird:

1. Fragt nach deinem Master-Lebenslauf → upload_master_resume (gib den Dateipfad an).

2. Parst ihn und fragt nur nach fehlenden Informationen → analyze_master_resume → setup_user_profile.

3. Nimmt eine Stellenbeschreibung, die du einfügst → analyze_job (zeigt ursprünglichen ATS + Lücken).

4. Erstellt einen maßgeschneiderten Lebenslauf → optimize_resume_for_job (Original vs. optimierter ATS, PDF + DOCX).

5. Bereitet die Bewerbung vor → generate_application_profile → prepare_application.

6. Zeichnet sie auf → apply_to_job (Phase 1: du übermittelst; Claude markiert sie nach deiner Bestätigung als APPLIED).

7. Verfolgt sie → update_application_tracking / search_application_emails.

8. Erstellt den Abschlussbericht → generate_application_report (PDF + Tracking-Seiten).

Beispielaufforderungen

• „Hier ist mein Lebenslauf: /Users/me/Documents/resume.pdf. Richte mein Profil ein.“

• „Analysiere diese Stelle im Vergleich zu meinem Lebenslauf: <JD einfügen>“

• „Optimiere meinen Lebenslauf für Bewerbung 1 und zeig mir den Vorher/Nachher-ATS-Score.“

• „Was hat sich geändert und was konntest du nicht verifizieren?“

• „Erstelle meinen Bewerbungsbericht.“

Konfiguration (.env)

Sicherheit und Datenschutz

• Deine Daten bleiben auf deinem Rechner unter RESUMEPILOT_DATA_DIR (git-ignoriert).

• Es werden niemals Passwörter oder OTPs von Dritten gespeichert; zukünftige Integrationen verwenden offizielle OAuth-/Session-Abläufe, wobei Tokens aus den Protokollen ferngehalten werden.

• Protokolle gehen nur an stderr und schwärzen geheimnisaussehende Werte.

• Lösche deine Daten jederzeit, indem du das Datenverzeichnis entfernst.

Projektstruktur

src/
├── index.ts, server.ts          # MCP stdio server + tool registration
├── context.ts                   # composition root
├── tools/                       # 17 MCP tools (thin, Zod-validated)
├── services/                    # parsing, scoring, optimization, tracking, reports
├── providers/                   # jobs / applications / email adapters (+ registries)
├── database/                    # SQLite schema + repository
├── models/                      # Zod schemas & types
└── utils/                       # config, logger, text/keyword processing, ids
tests/                           # vitest suite (40 tests)
docs/                            # ARCHITECTURE.md, Claude Desktop config
scripts/demo.ts                  # offline end-to-end demo

Roadmap

Phase 2: generischer Suchadapter, Worker-Pool, Deduplizierung, Ranking, ≤1.000 Jobs · Phase 3: unterstützte Job-Quellen-Integrationen · Phase 4: Bewerbungsadapter · Phase 5: Gmail-Tracking (OAuth) · Phase 6: gehostete Tracking-Oberfläche + Paketierung.

Lizenz

MIT – siehe LICENSE.