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)

... View full README on GitHub