Skip to main content
Glama

WorkMCP – Job-Graph Deutschland als MCP-Server

WorkMCP ist eine MCP-Kontextschicht für Rollen, Aufgaben und Automatisierung. Agent-Harnesses wie Claude Code, OpenCode oder Copilot Studio erhalten darüber Stellenanzeigen, Berufe, Aufgaben, Skills, Gehälter und Automatisierungssignale aus öffentlichen Quellen. Jeder Abruf wird lokal gemerkt. Neue und geänderte Daten werden versioniert ergänzt, nichts wird stillschweigend überschrieben.

Rechtlicher Hinweis: WorkMCP ist keine Rechtsberatung. Lizenzen und Nutzungsbedingungen der Datenquellen müssen Nutzende selbst prüfen. Eine Haftung für die Nutzung ist ausgeschlossen, soweit gesetzlich zulässig. Details stehen auf der Landingpage und im Rechtlichen Hinweis.

Was der Server kann

  • Stellenanzeigen aus drei sich ergänzenden Volltextquellen:

    • BA-Jobsuche als Deutschland-Kern.

    • Arbeitnow mit aggregierten ATS-Feeds, Remote- und Visa-Filter.

    • ATS-Karriereseiten direkt (Greenhouse, Lever, Ashby, Workable, Recruitee, Personio, SmartRecruiters, BambooHR, Workday) mit Abteilung, Seniority und Anstellungsart.

  • Berufe und Aufgaben:

    • BERUFENET mit Aufgaben, Tätigkeitsfeldern und KldB-Code.

    • ESCO mit essential/optional Skills und ISCO-Gruppe.

    • O*NET Task Statements (Core/Supplemental).

    • KldB 2010 inklusive Hierarchie als Jobfamilien.

  • Crosswalks KldB ↔ ISCO-08 ↔ ESCO ↔ O*NET ↔ BERUFENET, auch über mehrere Stufen.

  • Gehälter:

    • Amtliche Medianentgelte mit Quartilen aus dem Entgeltatlas der BA.

    • Optional Gehalts-Histogramme aus Adzuna (kostenloser Key).

  • Automatisierungssignale aus Hacker News. Aufgaben, Skills und Bewertungen speichert das Modell mit record_extraction versioniert im Graphen.

  • Rollenkontext in einem Aufruf (get_role_context): Zuordnung, Aufgaben, Skills, Gehalt und Marktsignal.

  • Job-Graph mit Knoten, Kanten und Herkunft, exportierbar als JSON, Neo4j-Cypher, GraphML oder als Archivy-Wissensdatenbank.

  • check_sources prüft die Erreichbarkeit aller Quellen vom eigenen Rechner aus.

Related MCP server: CodeMind

Schnellstart

Voraussetzungen: Python ≥ 3.10 und uv.

Claude Code (stdio, lokal):

claude mcp add workmcp -- uvx --from git+https://github.com/GodModeAI2025/WorkMCP workmcp

Mit eigenem Speicherort der Wissensdatenbank:

claude mcp add --transport stdio workmcp --env WORKMCP_DB=$HOME/.workmcp/knowledge.db -- uvx --from git+https://github.com/GodModeAI2025/WorkMCP workmcp

Aus einem lokalen Klon:

git clone https://github.com/GodModeAI2025/WorkMCP.git
claude mcp add workmcp -- uv --directory /pfad/zu/WorkMCP run workmcp

Zentral über Streamable HTTP (ein Server für mehrere Harnesses):

uvx --from git+https://github.com/GodModeAI2025/WorkMCP workmcp --transport streamable-http --host 0.0.0.0 --port 8000
claude mcp add --transport http workmcp http://<server>:8000/mcp

Der HTTP-Modus hat keine eigene Authentifizierung. Betreibe ihn nur im internen Netz oder hinter einem Reverse Proxy mit Zugangsschutz. Mit --allowed-host mcp.firma.de (mehrfach möglich) oder WORKMCP_ALLOWED_HOSTS prüft der Server zusätzlich den Host-Header (Schutz vor DNS-Rebinding). Das Compose-Setup aktiviert diese Prüfung standardmäßig für localhost.

Docker: WorkMCP und Archivy zusammen (zentraler MCP-Server plus Wissensdatenbank mit vorinstallierter Doku):

cp .env.example .env
docker compose up -d --build
  • Archivy: http://localhost:5000 (Login aus .env). Die Doku liegt im Ordner WorkMCP.

  • WorkMCP: http://localhost:8000/mcp, in Claude Code mit claude mcp add --transport http workmcp http://localhost:8000/mcp.

  • export_knowledge('archivy') schreibt die gemerkten Berufe direkt in denselben Archivy-Ordner. Beide Container teilen sich das Archivy-Volume (WORKMCP_ARCHIVY_DIR=/archivy/data).

  • Beide Ports sind nur an 127.0.0.1 gebunden. Bei Docker-Hub-Rate-Limits lassen sich in .env Spiegel-Images setzen (ARCHIVY_PYTHON_IMAGE, WORKMCP_PYTHON_IMAGE).

  • Getestet am 29.10.2026 mit Docker 29.9 und Compose v5.6: Start ohne Assistent, Login, Doku-Notizen sichtbar, Export aus WorkMCP erscheint sofort in Archivy, Neustart idempotent.

Projektkonfiguration .mcp.json:

{
  "mcpServers": {
    "workmcp": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/GodModeAI2025/WorkMCP", "workmcp"],
      "env": { "WORKMCP_DB": "~/.workmcp/knowledge.db" }
    }
  }
}

OpenCode (opencode.json):

{
  "mcp": {
    "workmcp": {
      "type": "local",
      "command": ["uvx", "--from", "git+https://github.com/GodModeAI2025/WorkMCP", "workmcp"],
      "enabled": true
    }
  }
}

Erste Schritte im Harness:

  1. check_sources prüft, ob alle Quellen erreichbar sind.

  2. import_reference_data('onet') lädt die O*NET-Aufgaben einmalig, die Version wird automatisch erkannt.

  3. get_role_context('Buchhalter', ort='Berlin') liefert den ersten Rollenkontext.

Gedächtnis: merken und ergänzen

Situation

Verhalten

Neuer Datensatz

wird gespeichert (Version 1, Ereignis neu)

Geänderter Datensatz

neue Version, alte Version bleibt erhalten, feldgenaues Diff (geaendert)

Unveränderter Datensatz

nur „zuletzt gesehen“ und der Abrufzähler werden aktualisiert

Anzeige nicht mehr abrufbar (404)

Status verschwunden, wird nie gelöscht; taucht sie wieder auf: wieder_da

Wiederholte Anfrage innerhalb der TTL

Antwort aus dem Speicher (aus_speicher: true)

Quelle nicht erreichbar

letzter gespeicherter Stand mit Warnung

aktualisieren: true

frischer Abruf; das Delta zeigt neu, geaendert und nicht_mehr_enthalten gegenüber der letzten identischen Anfrage

Offline-Modus (WORKMCP_OFFLINE=1)

nur Gedächtnis, keine Netzzugriffe

Werkzeuge zum Gedächtnis:

  • get_changes(seit='7d'): Änderungsprotokoll.

  • get_history(...): alle Versionen eines Datensatzes.

  • search_knowledge(...): Volltextsuche offline.

  • knowledge_stats(): Überblick.

  • remember(...): eigene Daten wie interne Rollenprofile oder Expertenfeedback, ebenfalls versioniert.

Tools

Bereich

Tools

Stellen

search_jobs (BA), get_job_details, search_arbeitnow, get_ats_jobs, commoncrawl_lookup

Berufe

search_occupation, get_occupation, get_tasks, get_skills, crosswalk, get_role_context

Gehalt

get_salary (Entgeltatlas), adzuna_salary (optional)

Automatisierung

find_automation_signals, record_extraction

Gedächtnis

remember, search_knowledge, get_changes, get_history, knowledge_stats, graph_neighbors

Daten und Betrieb

import_reference_data, export_knowledge, check_sources

Dazu kommt der Prompt rollen_analyse(rolle, ort). Er führt durch den Ablauf Rolle → Aufgaben → Automatisierung. Die vollständige Referenz steht in docs/archivy/WorkMCP/910004-Tools-Referenz.md.

Datenquellen

Alle integrierten Quellen sind kostenlos. Kostenpflichtige APIs wie Apify werden bewusst nicht genutzt.

Quelle

Zugang

Hinweise zu Lizenz und Bedingungen (selbst prüfen!)

BA-Jobsuche, BERUFENET, Entgeltatlas

JSON-Backends der BA-Web-Apps, öffentliche Client-IDs

Keine offiziell angebotene API, dokumentiert von bundesAPI. Endpunkte können sich ändern. Entgeltatlas: „Statistik der Bundesagentur für Arbeit“ als Quelle angeben.

ESCO

Web-API der EU-Kommission

Nutzungsbedingungen des ESCO-Portals, Quellenangabe

O*NET

Datenbank-Download (Text)

CC BY 4.0, Namensnennung von USDOL/ETA erforderlich; O*NET® ist eine Marke von USDOL/ETA

KldB 2010, Umsteigeschlüssel KldB→ISCO-08

Datei der BA-Statistik (Import)

Quellenangabe Bundesagentur für Arbeit

ESCO↔O*NET-Crosswalk

Datei vom ESCO-Portal oder O*NET (Import)

Bedingungen der Herausgeber

Arbeitnow

kostenlose API ohne Key

Bedingungen von Arbeitnow

ATS-Job-Boards

öffentliche Karriereseiten-Feeds ohne Login

robots.txt und Bedingungen der Arbeitgeber und ATS-Anbieter, schonend abrufen

Adzuna (optional)

kostenloser Developer-Key

Adzuna-API-Bedingungen, u. a. Verlinkung über redirect_url

Hacker News

Algolia-Such-API

Inhalte gehören den Verfassenden

Common Crawl

URL-Index und WARC-Abruf

Common Crawl Terms of Use; Urheberrecht der Seitenbetreiber

Nicht integriert sind LinkedIn, Indeed, StepStone und XING: keine Lese-API, Scraping verbieten die AGB. Ebenso Interamt (keine Lese-API) und Apify (kostenpflichtig). Die Einordnung steht im Faktencheck.

Datenschutz: Stellenanzeigen können personenbezogene Daten enthalten. Felder mit Kontaktpersonen, Telefonnummern, E-Mail-Adressen und Bewerbungsangaben werden vor dem Speichern entfernt. Mit WORKMCP_STORE_PERSONAL_DATA=1 lässt sich das abschalten; dann ist DSGVO-Konformität selbst sicherzustellen.

Referenzdaten importieren

import_reference_data('onet')                                  # automatisch neueste Version, CC BY 4.0
import_reference_data('kldb', quelle='/pfad/kldb2010.xlsx')    # KldB-2010-Systematik (Fassung 2020)
import_reference_data('kldb_isco', quelle='/pfad/umsteiger.xlsx')
import_reference_data('esco_onet', quelle='/pfad/esco_onet.csv')

Herkunft der Dateien:

Die Spalten werden an Kopfzeilen und Wertformen erkannt, Titelzeilen stören nicht. Wiederholte Importe melden neue, geänderte und entfallene Einträge, etwa zwischen zwei O*NET-Releases.

Konfiguration

Variable

Standard

Bedeutung

WORKMCP_DB

~/.workmcp/knowledge.db

Wissensdatenbank (SQLite)

WORKMCP_OFFLINE

0

nur Gedächtnis, keine Netzzugriffe

WORKMCP_TTL_JOBS_HOURS / _DETAILS_HOURS / _SIGNALS_HOURS

6 / 24 / 24

Gültigkeitsdauer für Stellen, Details und Signale

WORKMCP_TTL_REFERENCE_DAYS

30

Gültigkeitsdauer für Berufe und Referenzdaten

WORKMCP_LANGUAGE

de

Sprache für ESCO

WORKMCP_ESCO_VERSION

–

z. B. v1.2.1 (sonst Standard der API)

WORKMCP_ONET_VERSION

automatisch

z. B. 31_0

WORKMCP_ADZUNA_APP_ID / _APP_KEY

–

aktiviert Adzuna (kostenloser Key)

WORKMCP_STORE_PERSONAL_DATA

0

Kontaktfelder aus Stellenanzeigen speichern

WORKMCP_KLDB_SOURCE, _KLDB_ISCO_SOURCE, _ESCO_ONET_SOURCE

–

Standardquellen für den Import

WORKMCP_ARCHIVY_DIR

–

Archivy-Datenverzeichnis als Standardziel von export_knowledge('archivy')

WORKMCP_ALLOWED_HOSTS

–

erlaubte Host-Header für streamable-http, kommagetrennt (wie --allowed-host)

WORKMCP_BA_*, WORKMCP_ESCO_BASE, WORKMCP_HN_BASE …

siehe src/workmcp/config.py

Endpunkte und Client-IDs überschreiben

Graph-Modell

  • Knoten: Beruf, Klassifikation (KldB/ISCO, Hierarchie als Jobfamilien), Aufgabe, Skill, Stellenanzeige, Arbeitgeber, Branche, Region, Automatisierung, Entgelt.

  • Kanten: STELLT_AN, ERFORDERT, TEIL_VON (mit O*NET Core/Supplemental), AUTOMATISIERBAR_DURCH (Bewertung, Anteil an der Wochenarbeitszeit), GEHOERT_ZU, FUER_BERUF, IN_REGION, AUSGESCHRIEBEN_VON, KLASSIFIZIERT_ALS, ENTSPRICHT, UNTERGRUPPE_VON, HAT_ENTGELT.

Details stehen in docs/archivy/WorkMCP/910007-Job-Graph-Modell.md. Für Neo4j: export_knowledge('cypher'), dann cypher-shell < graph.cypher.

Dokumentation

  • Landingpage, für GitHub Pages aus dem Ordner /docs gedacht.

  • Archivy-Dokumentation: Notizen mit YAML-Front-Matter, direkt in eine Archivy-Wissensdatenbank kopierbar. export_knowledge('archivy') schreibt auch die gemerkten Berufe als verlinkte Archivy-Notizen.

  • Faktencheck der zugrunde liegenden Recherche.

Bekannte Grenzen

  • Die Clients sind gegen dokumentierte Antwortformate getestet (bundesAPI-OpenAPI, ESCO-HAL, O*NET-Dateilayout, live verifizierte ATS-Referenz). Gegen die Live-APIs konnten sie in der Entwicklungsumgebung nicht laufen, deren Netzwerk-Policy die Hosts sperrt. Vor dem Produktiveinsatz check_sources ausführen und Ergebnisse stichprobenartig prüfen.

  • Die Aufgaben-Extraktion aus BERUFENET ist heuristisch (Abschnitte „Aufgaben und Tätigkeiten“). Die Rohantwort wird immer vollständig gespeichert.

  • ONET-Aufgaben sind englisch und beschreiben US-Berufe. Für die Zuordnung zu deutschen Berufen werden ESCO-URIs und der ESCO↔ONET-Crosswalk empfohlen.

  • search_arbeitnow filtert lokal, weil die API keine Suchparameter für Begriff und Ort hat.

Entwicklung

uv sync --extra dev
uv run pytest
uv run ruff check src tests && uv run mypy src

Lizenz

MIT, siehe LICENSE. Die abgerufenen Daten unterliegen den Bedingungen ihrer jeweiligen Quellen.

Available Tools

24 tools
adzuna_salaryA
Idempotent

Gehaltsverteilung (Histogramm), Top-Arbeitgeber und optional Gehaltsverlauf aus Adzuna-Inseraten.

Optional: braucht einen kostenlosen Adzuna-Developer-Key (WORKMCP_ADZUNA_APP_ID/_APP_KEY). Für amtliche Medianentgelte nach Beruf get_salary (Entgeltatlas) verwenden.

Inputs: was (required), monate, standort, kategorie, +1 more. Returns: object

check_sourcesA
Idempotent

Erreichbarkeit aller Datenquellen von diesem Rechner aus prüfen (HTTP-Status und Latenz je Quelle).

Inputs: no named parameters. Returns: object

commoncrawl_lookupA
Idempotent

Common-Crawl-Index nach archivierten Seiten (z. B. Karriereseiten) durchsuchen und optional Text laden.

Inputs: url_muster (required), crawl, limit, text_abrufen. Returns: object

crosswalkA
Idempotent

Übersetzt Berufscodes zwischen KldB 2010, ISCO-08, ESCO, O*NET und BERUFENET (auch über mehrere Stufen).

Inputs: von (required), code (required), nach (required), sprache. Returns: object

export_knowledgeB
Idempotent

Graph exportieren: JSON, Neo4j-Cypher, GraphML oder als Archivy-Wissensdatenbank (Markdown-Notizen).

Inputs: pfad, format. Returns: object

find_automation_signalsC
Idempotent

Automatisierungssignale aus Hacker News (Berichte, wie Tätigkeiten automatisiert wurden).

Inputs: suchbegriff (required), limit, aufgabe_id, aktualisieren, +2 more. Returns: object

get_ats_jobsA
Idempotent

Offene Stellen direkt aus dem Bewerbermanagement eines Arbeitgebers (öffentliche Job-Board-APIs ohne Login).

Unterstützt Greenhouse, Lever, Ashby, Workable, Recruitee, Personio (XML), SmartRecruiters, BambooHR und Workday. Liefert Primärdaten wie Abteilung, Seniority, Anstellungsart. Das Delta zeigt neue und geschlossene Stellen seit dem letzten Abruf.

Inputs: company_slug (required), ats, ort, max_jobs, +2 more. Returns: object

get_changesC
Read-onlyIdempotent

Änderungsprotokoll des Gedächtnisses: was ist neu, geändert, verschwunden oder wieder aufgetaucht.

Inputs: art, seit, limit, quelle, +1 more. Returns: object

get_historyB
Read-onlyIdempotent

Alle gespeicherten Versionen eines Datensatzes mit feldgenauen Änderungen.

Inputs: art (required), quelle (required), schluessel (required). Returns: object

get_job_detailsA
Idempotent

Volltext und Details einer BA-Stellenanzeige (Beschreibung, Branche, Fertigkeiten, Vergütung).

Nicht mehr vorhandene Anzeigen werden im Gedächtnis als 'verschwunden' markiert. Kontaktpersonen werden vor dem Speichern entfernt (Datenminimierung).

Inputs: refnr (required), aktualisieren. Returns: object

get_occupationB
Idempotent

Profil eines Berufs bzw. einer Berufsklasse mit Klassifikation, Aufgaben, Skills und Verknüpfungen.

Inputs: beruf_id (required), sprache, aktualisieren. Returns: object

get_role_contextA
Idempotent

Rollenkontext in einem Aufruf: Zuordnung, Aufgaben (BERUFENET/O*NET), Skills (ESCO), Gehalt (Entgeltatlas) und Marktsignal (offene Stellen laut BA).

Inputs: rolle (required), ort, sprache, mit_signalen. Returns: object

get_salaryC
Idempotent

Amtliche Medianentgelte (mit Quartilen) nach Beruf aus dem Entgeltatlas der BA.

Inputs: kldb (required), alter, niveau, region, +3 more. Returns: object

get_skillsC
Idempotent

Skills eines Berufs: ESCO essential/optional plus Häufigkeiten aus gespeicherten BA-Stellenanzeigen.

Inputs: beruf (required), limit, sprache, relation. Returns: object

get_tasksB
Idempotent

Kanonische Aufgabenliste eines Berufs: O*NET Task Statements (Core/Supplemental) und BERUFENET-Tätigkeiten.

Die Zuordnung läuft über BERUFENET→KldB→ISCO→ESCO→O*NET (Crosswalks müssen importiert sein).

Inputs: beruf (required), limit, quellen, sprache, +1 more. Returns: object

graph_neighborsB
Read-onlyIdempotent

Nachbarn eines Knotens im Job-Graphen (Berufe, Aufgaben, Skills, Stellen, Branchen, Regionen ...).

Inputs: knoten (required), limit, richtung, kantentyp. Returns: object

import_reference_dataA
Idempotent

Referenzdaten importieren bzw. aktualisieren. Wiederholte Importe ergänzen neue/geänderte Einträge und markieren entfallene (z. B. zwischen O*NET-Releases).

Inputs: datensatz (required), quelle, onet_version, alternativtitel. Returns: object

knowledge_statsA
Read-onlyIdempotent

Überblick über das Gedächtnis: Datensätze je Quelle, Versionen, Graph-Knoten/-Kanten, letzte Abrufe.

Inputs: no named parameters. Returns: object

record_extractionA
Idempotent

Vom Modell oder von Fachexperten extrahierte Aufgaben, Skills und Automatisierungsbewertungen versioniert im Graphen speichern. Liefert Vorschläge passender kanonischer Aufgaben (Deduplizierung).

Inputs: bezug (required), quelle, skills, aufgaben, +1 more. Returns: object

rememberA
Idempotent

Eigene Daten (interne Rollenprofile, Expertenfeedback) versioniert im Gedächtnis speichern oder ergänzen.

Inputs: art (required), daten (required), schluessel (required), titel, +1 more. Returns: object

search_arbeitnowA
Idempotent

Stellen von Arbeitnow (kostenlos, ohne Schlüssel; aggregiert ATS-Feeds wie Greenhouse, Personio, Recruitee).

Gefiltert wird lokal über die abgerufenen Seiten; alle abgerufenen Stellen werden gespeichert.

Inputs: ort, was, seiten, remote_only, +2 more. Returns: object

search_jobsA
Idempotent

Stellensuche in der Jobbörse der Bundesagentur für Arbeit (größter Stellenbestand in Deutschland).

Speichert jede Anzeige im Gedächtnis und meldet im Delta neue, geänderte und nicht mehr enthaltene Anzeigen gegenüber der letzten identischen Suche. Details mit get_job_details(refnr).

Inputs: wo, was, seiten, groesse, +9 more. Returns: object

search_knowledgeB
Read-onlyIdempotent

Offline-Suche im Gedächtnis (auch zur Zuordnung freier Aufgabentexte zu kanonischen Aufgaben).

Inputs: suchbegriff (required), art, limit, quelle. Returns: object

search_occupationB
Idempotent

Berufe finden: BERUFENET (mit KldB-Zuordnung), ESCO-Berufe, KldB-Systematik und O*NET-Titel.

Inputs: query (required), limit, quellen, sprache, +2 more. Returns: object

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.4/5.0

    Scored across 24 tools

    Disambiguation4/5

    Tools mostly target distinct sources or actions: search_jobs (BA), search_arbeitnow, and get_ats_jobs are separated by source, and get_salary (official median) vs adzuna_salary (histogram) is explained in descriptions. Slight overlap remains between search_knowledge and get_changes/get_history, and between find_automation_signals and commoncrawl_lookup, but boundaries are mostly clear.

    Naming Consistency4/5

    Dominant verb_noun snake_case pattern (search_jobs, get_job_details, import_reference_data, export_knowledge) is applied consistently. Minor deviations exist with noun-first/source-prefixed names (adzuna_salary, commoncrawl_lookup, graph_neighbors, knowledge_stats) and single verbs (crosswalk, remember), but the convention stays readable.

    Tool Count3/5

    24 tools is heavy and sits in the borderline range, though the server spans several sub-domains (job search, occupation/task/skill data, salary, knowledge graph, change tracking, export). Each tool maps to a real operation, but the surface is large enough to burden tool selection.

    Completeness4/5

    Coverage is broad: multi-source job search and details, occupation/task/skill lookups, salary data, crosswalks, versioned memory storage, change/history tracking, graph traversal, export, and source health checks. Minor gaps like no explicit delete/forget tool for stored records and no direct occupation-to-job matching helper, but agents can work around these.

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      B
      maintenance
      Provides agent coordination for Claude Code through a shared blackboard, decision tracking with rationale, and local semantic search over git-trackable JSONL files. It enables users to assemble tailored context packages and manage a lightweight knowledge graph for complex development tasks.
      15
      208 npm
      7
      MIT
    • F
      license
      Not graded
      quality
      D
      maintenance
      Provides persistent codebase memory and semantic context for AI agents via AST-aware chunking and symbol graph indexing.
      1
      -
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables coding agents to query a local, versioned knowledge graph of a software project, retrieving overviews, context packs, evidence, and explanations to make informed changes.
      MIT