Skip to main content
Glama
german-legal-engine

german-legal-engine

by rzgrw

German Legal Engine (GLE)

Python-SDK, Kommandozeile und MCP-Server für Recherche und juristische Arbeitshilfen in Deutschland. Der Versionswert 1.0.0 ist vorläufig beibehalten und kein Nachweis einer veröffentlichten oder fachlich abgenommenen Version. Änderungen stehen im Changelog; Entwicklung und Abnahme sind in der Roadmap und im Release-Handbuch beschrieben.

Vorhandener Umfang

  • Bundesnormen aus gesetze-im-internet.de, Rechtsprechungssuche und Entscheidungsabruf aus Rechtsprechung im Internet und dem bayerischen Portal.

  • Ereignisfristen mit Berechnungsschritten; Fristtyp, Zustellung und örtliche Feiertage benötigen eine eigenständige fachliche Prüfung.

  • Acht redaktionelle Tatbestandsmodelle: BGB §§ 823 Abs. 1, 280 Abs. 1, 314, 535 Abs. 1 Satz 2, 551 und 626; KSchG § 1; OWiG § 67.

  • Musterbasierte Redaktion personenbezogener Daten, unverbindliche Eingangseinschätzung mit optionalem Laya und Zusammenstellung eines Recherchedossiers.

Diese Funktionen waren bereits vor der Release-Basis vorhanden. KMU-Skills etwa für Forderungen oder E-Rechnungen sind geplant und noch nicht implementiert. Die Software erteilt keine fachliche Freigabe für Verträge, Fristen, Schriftsätze oder Compliance.

Related MCP server: German Law MCP Server

Installation aus dem Quellstand

Python ab 3.10; die CI prüft 3.10, 3.11 und 3.12. Eine geprüfte Installation setzt Internetzugang zur Auflösung der Abhängigkeiten voraus.

python3 -m venv .venv
.venv/bin/python -m pip install .
.venv/bin/gle --version
.venv/bin/gle --help

Nur das optionale Extra installiert Laya:

.venv/bin/python -m pip install '.[laya]'

Die optionale Modellinitialisierung kann Gewichte aus einem externen Modellregister herunterladen und lokal speichern. Laufzeit, Modellrevision und Kalibrierung sind nicht allgemein nachgewiesen. Ohne nutzbares Modell wird eine Heuristik verwendet; ihre Werte sind keine validierten Wahrscheinlichkeiten.

Python und Kommandozeile

from german_legal_engine import LegalEngine, __version__

# Lokale, redaktionelle Arbeitshilfe ohne Portalabruf.
result = LegalEngine.get_subsumption_blueprint("BGB", "823")
if result.get("success"):
    print(result["blueprint"]["norm"])
gle norm BGB 823
gle search 'Mietkaution Rückzahlung' --source BUND --limit 3
gle decision 'DOKUMENTKENNUNG_AUS_DER_SUCHE'
gle deadline 2026-10-02 3 wochen --state BY --audit
gle subsume BGB 823
gle triage 'Bitte einen deutschen Kaufvertrag prüfen' --state NW

Alle erfolgreichen Fristenrechnungen benötigen weiterhin fachliche Anwendbarkeitsprüfung. Die Fristenrechnung bestimmt die Anwendbarkeit einer gesetzlichen Frist nicht selbst. Beispielsweise muss der Anwender Ereignis, Rechtsgrundlage, Fristtyp und lokale Feiertage vorher klären. Datumserkennung aus Freitext ist keine Festlegung eines Fristbeginns.

Geändertes CLI-Verhalten: gle --version zeigt die gemeinsame Produktversion. Erfolgreiche Befehle liefern Exitcode 0; Abruf-/Verarbeitungsfehler, fehlende Tatbestandsmodelle und Suchteilausfälle liefern 1; ungültige Eingaben und nicht belastbar berechenbare Fristen liefern 2. Nicht belastbare Triage-Ergebnisse liefern ebenfalls 1; Eskalationsgründe, Redaktionshinweise und Grenzen werden angezeigt. Fehler stehen auf stderr; bei Suchteilausfällen bleiben vorhandene Treffer auf stdout. Ein Aufruf ohne Befehl liefert 2 statt eines scheinbaren Erfolgs. Skripte müssen die Exitcodes beachten. Menschliche Ausgaben sind kein zugesagtes JSON-Format; diese Änderung darf nach einer belegten Veröffentlichung nicht ungeprüft als Patch erscheinen.

MCP

german-legal-mcp --transport stdio
german-legal-mcp --version

Ein MCP-Host startet den Konsoleneinstieg als Prozess mit --transport stdio. Der Client handelt die Protokollversion aus; diese ist unabhängig von der GLE-Produktversion. Das offizielle Python-SDK wird auf die lokal getestete Spanne mcp>=1.25.0,<1.26.0 begrenzt. SSE ist derzeit nicht abgenommen: --transport sse meldet einen deutschen Fehler und Exitcode 2. Die bisherigen Optionen --host und --port bleiben für diesen gesperrten Transport erkennbar, öffnen aber keinen Server.

Alle acht Werkzeugnamen bleiben bestehen:

Werkzeug

Ergebnis über MCP

get_norm

JSON als Text

search_precedents

JSON als Text

get_decision

JSON als Text

compute_deadline

JSON als Text, auch bisheriges error-Objekt

get_subsumption_blueprint

JSON als Text

anonymize_text

Klartext

triage_mandate

JSON als Text

prepare_pleading_dossier

Klartext

Es gibt keine stille Umstellung auf structuredContent. Die öffentliche Server-API des offiziellen SDK übernimmt den Protokollablauf. Prüfskript und Vertragstests verwenden den echten SDK-Client mit Initialisierung, Werkzeugauflistung und harmlosen lokalen Werkzeugaufrufen.

Quellen, Datenflüsse und Grenzen

Die Quellen- und Regelkorrekturen sind im gemeinsamen Quellstand integriert; unabhängige Gesamtprüfung und fachliche Abnahme bleiben offen. Sie begrenzen die tatsächlich benötigten Feiertagsjahre auf Jahre ab 2026; ein früheres Ereignisdatum ist dadurch nicht pauschal ausgeschlossen. Sie weisen entscheidungserheblich ungeklärte Ortsfeiertage zurück: BY am 8./15. August, SN/TH an Fronleichnam. Spätere Rechtsänderungen und einmalige Feiertage sind damit nicht automatisch geprüft. Ungültige Dauer/Bundesländer liefern Eingabefehler. Die geprüften Negativfälle BGB § 823 Abs. 2 und § 280 Abs. 9 ergeben keinen ersatzweisen Blueprint; absatzlose Aufrufe weisen auf den tatsächlich verwendeten Absatz hin. Absatz-/Satzrollen werden in zulässiger Reihenfolge geprüft; wiederholte, widersprüchliche und nicht unterstützte explizite Angaben erhalten keinen Ersatzgraphen. Die tatsächliche Blueprint-Norm bleibt mit der Anfrage abzugleichen.

Portaltexte werden extrahiert und normalisiert. Aufbereiteter Inhalt ist kein beweiskräftiges wortlautidentisches Original; Fundstelle, Dokumentkennung, Abrufzeit und Quellenstatus müssen geprüft werden. Ein aktueller Abruf belegt keinen historischen Rechtsstand. Die Volltextausgaben unterscheiden text_raw beziehungsweise content_raw vom bereinigten Text, ergänzen source_url, identity_verified und text_kind und setzen is_official_verbatim=False für normalisierte Ausgaben. leitsatz_origin="ungeklärt" bescheinigt keine amtliche Leitsatzherkunft. Rohtext ist extrahierter Text, kein Original-HTML. Dossiers zeigen die genaue Blueprint-Norm und ihren Umfang; ein nicht verfügbares Tatbestandsmodell wird ausdrücklich benannt. Die HTTP-Kennungen aller drei Quellenmodule übernehmen dieselbe Produktversion wie SDK, CLI und MCP. Portalfehler, fehlende Treffer oder unvollständige Dossiers sind keine Bestätigung, dass kein relevantes Recht existiert.

Norm- und Rechtsprechungsabrufe kontaktieren die genannten externen Portale. Suchbegriffe, Dokumentkennungen und Verbindungsdaten können dort anfallen. Unbereinigte Mandantendaten gehören nicht in Suchanfragen. Die Regex-Redaktion erkennt nur bestimmte Muster und garantiert keine vollständige Anonymisierung. Der verwendete Agenten-Host, optionale Modelle, Protokollierung und eigene Infrastruktur bestimmen weitere Datenflüsse. Details und offene Pflichten stehen in COMPLIANCE.md.

Prüfung und Entwicklung

.venv/bin/python -m pip install -e . build
.venv/bin/python scripts/run_tests.py --mode offline
.venv/bin/python scripts/run_tests.py --mode live
.venv/bin/python -m unittest discover -s tests -v
.venv/bin/python -m build
.venv/bin/python scripts/check_packages.py --report /tmp/gle-paketnachweis.json

Die vollständige Suite enthält Live-Portaltests. Skips werden mit Grund ausgewiesen und beweisen keinen funktionierenden Abruf. Wheel und sdist werden jeweils in einer frischen virtuellen Umgebung außerhalb des Quellbaums installiert und mit pip check, SDK, beiden Konsoleneinstiegen und MCP geprüft. Lokale Ergebnisse ersetzen weder die Python-Matrix noch unabhängige technische und fachliche Abnahme. Siehe Anweisungen für Beiträge.

Lizenz: MIT.

Available Tools

6 tools
compute_deadlineB

Calculate German procedural deadlines under §§ 187-193 BGB and ZPO with weekend and statutory holiday shifting across all 16 German states.

Inputs: dauer_wert (required), ereignis_datum (required), state, dauer_einheit. Returns: result

get_decisionA

Retrieve the authentic full text and Randnummern of a court decision by document ID.

Inputs: doc_id (required). Returns: result

get_normA

Retrieve official, verbatim German federal or state statutory law (BGB, ZPO, KSchG, StGB, RVG, AufenthG, etc.) directly from official government repositories.

Inputs: law (required), section (required). Returns: result

get_subsumption_blueprintB

Retrieve directed legal subsumption blueprints: Tatbestandsmerkmale, factual details, burden of proof (Beweislast), and statutory legal consequences.

Inputs: law (required), section (required). Returns: result

prepare_pleading_dossierB

Prepare an executive, citation-grounded legal context dossier for drafting court pleadings or legal briefs without hallucinations or dashes.

Inputs: norms (required), query (required). Returns: result

search_precedentsC

Search authentic German court case law: federal courts (BGH, BAG, BVerfG, BVerwG, BFH) via Rechtsprechung im Internet and Bavarian courts (AG/LG/OLG München) via gesetze-bayern.de.

Inputs: query (required), court, limit, source. Returns: result

Tool Schema Changelog

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

Loading tool schema changelog…

    TDQS

    A3.5/5.0

    Scored across 6 tools

    Disambiguation4/5

    search_precedents (case law search) and get_decision (full text by ID) are related but clearly distinct actions, and get_norm cleanly separates statutes from case law. get_subsumption_blueprint and prepare_pleading_dossier both support drafting and could be momentarily confused, but their descriptions differentiate blueprint retrieval from dossier preparation.

    Naming Consistency5/5

    All six tools follow a consistent verb_noun snake_case pattern: search_precedents, get_decision, compute_deadline, get_subsumption_blueprint, prepare_pleading_dossier, get_norm. No mixing of conventions.

    Tool Count4/5

    Six tools is well-scoped for a focused legal engine covering case law, statutes, deadlines, and drafting. Each tool earns its place, though the surface is somewhat lean for the breadth of the legal domain.

    Completeness4/5

    The set covers the core legal research and drafting lifecycle: finding precedents, retrieving decisions and norms, computing deadlines, and preparing pleadings. Minor gaps exist (e.g., no explicit citation formatting or update/versioning, appeal lifecycle), but the primary workflows are covered.

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      C
      maintenance
      Provides access to the official German Federal Legal Information Portal (rechtsinformationen.bund.de) enabling AI agents to search German federal laws, court decisions, and legal documentation with authoritative citations from official sources.
      5
      24
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      Enables AI agents to query German federal and state statutes, court decisions, and citation graphs, grounding citations, retrieving provision texts and versions, and understanding coverage limits through read-only tools.
      9
      1
      AGPL 3.0