iflow-mcp_floleuerer-deutsche-gesetze-mcp 0.1.1

A German laws MCP server using FastMCP

Deutsche Gesetze MCP Server

Dieser Server implementiert das Model Context Protocol (MCP), um deutschen Gesetzestexte für LLMs (Large Language Models) bereitzustellen. Er ermöglicht es KI-Assistenten, gezielt nach Gesetzen zu suchen und spezifische Paragraphen abzurufen.

Die Gesetzestexte werden aus Markdown-Dateien geparst, die dem Format des Bundestag/gesetze Repositories entsprechen (Hinweis: Dieses Repository ist veraltet und dient nur zu Demozwecken).

Funktionen

• Gesetze auflisten & suchen: Durchsuchen der verfügbaren Gesetze (z.B. BGB, StGB, HGB).
• Volltextsuche: Suche nach Begriffen in den Gesetzestexten.
• Paragraphen abrufen: Abruf des Volltextes spezifischer Paragraphen (inkl. Absätze).
• Flexible Datenquellen: Laden der Gesetze aus einem lokalen Ordner oder direkt von GitHub.

Installation

Lokal

1. Repository klonen:

   git clone https://github.com/floleuerer/deutsche-gesetze-mcp.git
   cd deutsche-gesetze-mcp
   

2. Abhängigkeiten installieren: Es wird empfohlen, eine virtuelle Umgebung zu verwenden (z.B. venv oder conda).

   pip install -r mcp/requirements.txt
   

Docker (Empfohlen)

Die Docker-Version klont automatisch das gesamte Bundestag/gesetze Repository (veraltet, nur Demo) in das Image, sodass alle Gesetze sofort lokal verfügbar sind.

1. Image bauen:

   docker build -t deutsche-gesetze-mcp .
   

2. Container starten:

   docker run -p 8001:8001 deutsche-gesetze-mcp
   

Datenvorbereitung

Das Projekt enthält im Ordner prepare_data Skripte, um aktuelle Gesetzestexte direkt von www.gesetze-im-internet.de herunterzuladen und für den Server aufzubereiten.

1. Skript ausführen:

   cd prepare_data
   ./prepare_gesetze_im_internet.sh
   

   Dies lädt die Gesetze herunter, entpackt sie und konvertiert sie in das benötigte Format.

Konfiguration

Die Konfiguration erfolgt über Umgebungsvariablen oder eine .env Datei. Die Einstellungen werden in mcp/config.py definiert.

Variable	Beschreibung	Standardwert
LOAD_FROM_FOLDER	Pfad zu einem lokalen Ordner mit Gesetzes-Markdown-Dateien.	/app/gesetze/
LOAD_FROM_GITHUB	JSON-Liste von Gesetzeskürzeln, die von GitHub geladen werden sollen (überschreibt LOAD_FROM_FOLDER, wenn gesetzt).	None
MIN_PARAGRAPHS	Minimale Anzahl an Paragraphen, damit ein Gesetz geladen wird.	5

Beispiel .env Datei: Um Gesetze direkt von GitHub zu laden (z.B. BGB und StGB):

LOAD_FROM_GITHUB='["BGB", "StGB"]'
LOAD_FROM_FOLDER=

Um lokale Dateien zu nutzen (angenommen, sie liegen in ./gesetze):

LOAD_FROM_FOLDER=./gesetze

Nutzung

Server starten

Der Server kann direkt über Python gestartet werden. Er nutzt FastMCP und stellt standardmäßig einen HTTP-Server auf Port 8001 bereit.

python mcp/server.py

Tests

Die Tests können mit pytest ausgeführt werden. Um die Tests zu starten, muss der mcp Ordner im Python-Pfad liegen:

PYTHONPATH=mcp python3 -m pytest mcp/tests

Verfügbare Tools

Der Server stellt folgende MCP-Tools zur Verfügung:

1. get_lawlibrary(law: str | None)

   • Listet verfügbare Gesetze auf.
   • Parameter law: (Optional) Suchbegriff oder Kürzel, um die Liste zu filtern (z.B. "BGB").
   • Gibt eine JSON-Liste der gefundenen Gesetze zurück.

2. get_paragraph(law: str, paragraph: str)

   • Ruft den Inhalt eines Paragraphen ab.
   • Parameter law: Das Kürzel des Gesetzes (z.B. "BGB").
   • Parameter paragraph: Die Nummer des Paragraphen (z.B. "1", "14a").
   • Gibt den Text des Paragraphen (und ggf. spezifische Absätze) zurück.

3. search_laws(query: str, laws: list[str] | None)

   • Volltextsuche über alle oder ausgewählte Gesetze.
   • Parameter query: Der Suchbegriff (z.B. "Schadensersatz", "Kündigung").
   • Parameter laws: (Optional) Liste von Gesetzeskürzeln zur Einschränkung der Suche (z.B. ["BGB", "HGB"]).
   • Gibt eine Liste von Treffern mit Paragraphen und Textausschnitten zurück.

Verwendung mit MCP-Clients

Dieser Server kann mit jedem MCP-kompatiblen Client verbunden werden. Da er als HTTP-Server (SSE) läuft, muss der Client entsprechend konfiguriert werden, um sich mit http://localhost:8001/mcp zu verbinden.

Ein Beispiel für die Integration in einen KI-Agenten findest du im Ordner google-adk-agent, der das Google Agent Development Kit (ADK) nutzt.

Datenformat

Der Parser erwartet Markdown-Dateien, wie sie im Projekt bundestag/gesetze (veraltet, nur Demo) verwendet werden. Die Struktur sieht typischerweise so aus:

---
Title: Bürgerliches Gesetzbuch
jurabk: BGB
---

# § 1 Beginn der Rechtsfähigkeit

Die Rechtsfähigkeit des Menschen beginnt mit der Vollendung der Geburt.
...

Lizenz

Siehe LICENSE Datei.