⚖️ LexGuard MCP (법실마리)

Ein MCP-Server, der koreanische Gesetze, Präzedenzfälle und Rechtsauslegungen in einer für KI leicht verständlichen Form verbindet

Basiert auf den offiziellen Daten des Nationalen Rechtsinformationszentrums (Open Law) und bietet Gesetze, Artikel, Präzedenzfälle, Rechtsauslegungen, Verwaltungsentscheidungen und Verfassungsgerichtsurteile in einem einzigen Fragefluss.

• Ausführungsweise: Ein self-hosted MCP-Server, der mit Ihrem eigenen API-Schlüssel des Nationalen Rechtsinformationszentrums läuft (kein separater Hosting-Dienst)

• GitHub: https://github.com/SeoNaRu/lexguard-mcp

Schnellstart (5 Minuten)

1. API-Schlüssel erhalten — Kostenlos auf open.law.go.kr. Bei der Beantragung ist die Registrierung Ihrer eigenen IP erforderlich (siehe API-Schlüssel erhalten unten)

2. Server starten

   git clone https://github.com/SeoNaRu/lexguard-mcp
   cd lexguard-mcp
   cp .env.example .env        # LAW_API_KEY=발급키 설정
   docker compose up --build   # 또는: pip install -r requirements.txt && python -m src.main

3. Client verbinden — MCP-URL: http://localhost:9099/mcp

   • Cursor: examples/cursor-mcp.local.json Inhalt in .cursor/mcp.json zusammenführen

   • Claude Desktop: examples/claude-desktop-mcp.local.json → in mcpServers der claude_desktop_config.json zusammenführen (Node.js erforderlich)

Statische Metadaten für Marktplatz und Crawler: mcp/manifest.json · Prompt-Index prompts/ · Ressourcen-URI-Anleitung resources/README.md · Cursor-Entwicklungsskill .cursor/skills/lexguard-mcp-dev/SKILL.md

Why LexGuard?

Das Gesetz fühlt sich jedes Mal, wenn man es braucht, fern und schwierig an. Hohe Kosten, fremde Begriffe, eine Struktur, bei der man nicht weiß, wo man anfangen soll.

LexGuard MCP(법실마리) ist aus diesem Problem heraus entstanden.

• Nutzer fragen in menschlicher Sprache

• Die KI analysiert die Absicht der Frage

• und liefert dann auf der Grundlage offizieller Gesetzes- und Präzedenzfalldaten einen Anhaltspunkt.

Es ersetzt keine Beurteilung oder Rechtsberatung. Ziel ist es jedoch, den ersten Moment der Begegnung mit dem Gesetz weniger schwierig zu machen.

Related MCP server: LexLink

Core Features

MCP Tools

legal_qa_tool — Allgemeine Rechts-QA

Der zentrale Einstiegspunkt für alle Rechtsfragen. Mit einer einzigen Frage werden Gesetze, Präzedenzfälle, Auslegungen und Ausschussentscheidungen parallel durchsucht und zusammengefasst. Für quellenbegrenzte Suchen (nur Präzedenzfälle, nur Auslegungen usw.) können die jeweiligen Spezialtools verwendet werden.

Funktionen

• Automatische Klassifizierung in 10 Domänen

• Mehrfache Erkennung der Frageintention (Intent) und Prioritätssortierung

• Parallele Suche: Gesetze → Präzedenzfälle → Auslegungen → Ausschüsse

• Filterung nach natürlichen Zeitbedingungen (automatische Umwandlung in date_from / date_to)

Eingabeschema

Beispiel-Prompts

프리랜서인데 근로자성 인정된 판례 있나요?
최근 3년 부당해고 판례 알려줘
개인정보 유출됐는데 법적으로 어떻게 되나요?
2023다12345 판례 찾아줘

law_article_tool — Präzise Abfrage von Gesetzesartikeln

Ruft eine bestimmte Bestimmung direkt ab, wenn Gesetzesname und Artikelnummer bekannt sind. Wenn legal_qa_tool die "Suche" ist, ist dieses Tool die "präzise Abfrage".

Eingabeschema

Beispiel-Prompts

근로기준법 제50조 내용 알려줘
민법 제750조 3항이 뭐야?
개인정보보호법 제17조

law_comparison_tool — Vergleich von Gesetzen: Alt/Neu, Historie, 3-stufig

Ruft auf Basis des Gesetzesnamens Vergleiche zwischen altem und neuem Recht, die Historie und 3-stufige Vergleiche ab. Für den Originaltext von Artikeln verwenden Sie law_article_tool, für allgemeine Fragen legal_qa_tool.

Eingabeschema

Beispiel-Prompts

근로기준법 신구법 비교 보여줘
민법 연혁 조회

document_issue_tool — Analyse von Verträgen und AGB

Wenn Sie ein Dokument einfügen, werden rechtliche Probleme pro Klausel extrahiert und automatisch relevante Gesetze und Präzedenzfälle durchsucht.

Eingabeschema

Unterstützte Dokumenttypen

• labor — Arbeitsvertrag / Dienstleistungsvertrag

• lease — Mietvertrag

• terms — Nutzungsbedingungen

Beispiel-Prompts

이 프리랜서 계약서 문제 있는지 봐줘
아래 임대차 계약서에서 불리한 조항 찾아줘

health — Serverstatus prüfen

Prüft den Betriebsstatus des MCP-Servers, den API-Key-Status und Umgebungsvariablen.

Spezielle Suchtools (quellenbegrenzt)

Verwenden Sie diese, wenn Sie statt der integrierten Suche (legal_qa_tool) nur bestimmte Daten suchen möchten.

Erweiterte Abfragetools

Verwenden Sie diese für vertiefte Abfragen wie Zusatzinformationen zu Gesetzen, Historie, Formulare und Verknüpfungen.

ministry_interpretation_tool — Rechtsauslegungen nach Ministerien

Durchsucht die Datenbank für Rechtsauslegungen (Anfrage-Antwort) von 39 Ministerien. Wenn interpretation_tool die integrierte Suche ist, ruft dieses Tool nur die Auslegungen eines bestimmten Ministeriums direkt ab.

Unterstützte Ministerien: 고용노동부, 국토교통부, 기획재정부, 국세청, 관세청, 교육부, 보건복지부, 법무부, 법제처, 식품의약품안전처, 경찰청, 소방청, 해양경찰청 und 39 weitere Behörden

law_history_tool — Änderungshistorie von Gesetzen und Artikeln

Verfolgt, wann und wie ein Gesetz geändert wurde.

Beispiel-Prompts

근로기준법 개정 이력 알려줘
개인정보보호법 제17조 조문 개정 내역

law_info_tool — Zusatzinformationen zu Gesetzen

Ruft Zusatzinformationen wie englische Gesetzestexte, internationale Verträge, Gesetzesstrukturdiagramme, Übersichten und Kurztitel ab.

law_form_tool — Suche nach Anhangformularen

Durchsucht Anhangformulare von Gesetzen, Verwaltungsvorschriften und kommunalen Vorschriften nach Formularname oder zugehörigem Gesetzesnamen.

law_link_tool — Verknüpfungsabfrage Gesetz–kommunale Vorschriften

Zeigt die Liste der mit einem bestimmten Gesetz verknüpften Satzungen sowie den Verknüpfungsstatus nach zuständigem Ministerium und lokaler Gebietskörperschaft.

MCP Prompts

Unterstützt die Endpunkte prompts/list und prompts/get.

MCP Resources

Unterstützt die Endpunkte resources/list und resources/read.

URI Scheme

Featured Resources (standardmäßig enthalten)

Wichtige Gesetze wie 근로기준법, 민법, 형법, 개인정보보호법, 상법, 국가공무원법, 행정소송법 können sofort abgerufen werden.

Installation

Method 1. Local (Python)

git clone https://github.com/SeoNaRu/lexguard-mcp
cd lexguard-mcp
pip install -r requirements.txt
cp .env.example .env   # LAW_API_KEY 설정
python -m src.main

Method 2. Docker Compose (empfohlen · fast eine Zeile)

git clone https://github.com/SeoNaRu/lexguard-mcp
cd lexguard-mcp
cp .env.example .env   # LAW_API_KEY 편집
docker compose up --build

Browser/Client-MCP-URL: http://localhost:9099/mcp · Health: http://localhost:9099/health

Method 3. Docker (nur run)

docker build -t lexguard-mcp .
docker run -p 9099:9099 -e LAW_API_KEY=your_key lexguard-mcp

Client-Verbindung

Wenn der Server lokal läuft, lautet die MCP-URL http://localhost:9099/mcp.

Cursor (.cursor/mcp.json) — identisch mit der Datei examples/cursor-mcp.local.json:

{
  "mcpServers": {
    "lexguard-mcp": {
      "url": "http://localhost:9099/mcp"
    }
  }
}

Claude Desktop (claude_desktop_config.json) — identisch mit der Datei examples/claude-desktop-mcp.local.json. Da Claude Desktop lokale HTTP-URLs nicht direkt unterstützt, wird die mcp-remote-Brücke verwendet (Node.js erforderlich):

{
  "mcpServers": {
    "lexguard-mcp": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "http://localhost:9099/mcp"]
    }
  }
}

Hinweis zum claude.ai-Web-Connector: Der Web-Connector benötigt eine öffentliche HTTPS-URL und kann daher nicht mit einem lokal laufenden Server verbunden werden. Wir empfehlen die Verwendung von Claude Desktop oder Cursor. Wenn Sie es unbedingt im Web verwenden müssen, stellen Sie es auf einem eigenen Server (feste IP + HTTPS) bereit und registrieren Sie diese IP bei open.law.go.kr.

API-Schlüssel erhalten (erforderlich)

Ein Open-API-Schlüssel des Nationalen Rechtsinformationszentrums ist erforderlich. Ausstellung und Nutzung sind kostenlos.

1. Registrierung bei https://open.law.go.kr

2. OPEN-API-Nutzung beantragen — dabei muss die IP oder Domain des Servers (Ihres PCs), von dem die Anfragen gesendet werden, registriert werden. law.go.kr akzeptiert nur Anfragen von registrierten IPs.

3. LAW_API_KEY=발급받은키 in .env festlegen

Achtung bei dynamischen IPs: Bei normalen Haushaltsanschlüssen kann sich die IP ändern. Wenn der Fehler "사용자 정보 검증에 실패하였습니다" auftritt, registrieren Sie unter [open.law.go.kr → API인증키관리] die aktuelle IP neu.

DRF-Schema auswählen

lexguard-mcp hält host/path der DRF-URL des Nationalen Rechtsinformationszentrums fest und erlaubt die Auswahl nur des Schemas über .env.

LAW_GO_KR_DRF_SCHEME=https

• Zulässige Werte: http, https

• Standardwert: https

• In eingeschränkten Unternehmensnetzwerken/Firewall-Umgebungen kann der Pfad http://www.law.go.kr/DRF/... gemäß den offiziellen Leitfadenbeispielen erforderlich sein.

Diese Einstellung ist eine Option, um ein latentes URL-Generierungsproblem, das durch hartcodiertes https in normalen Umgebungen zufällig verdeckt werden konnte, je nach Betriebsumgebung anzupassen.

Architecture

Client (Cursor / Claude)
    │ JSON-RPC 2.0 over SSE
    ▼
FastAPI  (/mcp POST)
    │ Rate Limiting (slowapi, 600 req/min/IP 기본값)
    ▼
MCP Routes  (tools/call · prompts/get · resources/read)
    │
    ▼
Services  (SmartSearchService · SituationGuidanceService)
    │ asyncio.gather (병렬 멀티 API 호출)
    ▼
Repositories  (Law · Precedent · Interpretation · Appeal · Constitutional …)
    │ httpx (동기/비동기 HTTP 클라이언트)
    │ TTLCache (검색 결과 30분 / 실패 5분)
    │ Exponential Backoff Retry
    ▼
국가법령정보센터 DRF API  (159개 엔트리 / 88개 unique target)

Suchpipeline

질문 입력
    → 판례 번호 패턴 조기 감지 (2023다12345 / 2021헌마123)
    → 도메인 분류 + 의도(Intent) 분석
    → 시간 조건 파싱
    → asyncio.gather 병렬 API 호출
    → Reranker (BM25 + Keyword Hybrid 재정렬)
    → 응답 포매팅

Wichtigste Technologie-Stack

Entwicklung

# 테스트 실행
pytest tests/ -v

# 린트
ruff check src/

# 로컬 서버 (자동 재로드)
RELOAD=true python -m src.main

Lizenz

Der vollständige Text folgt der LICENSE-Datei im Repository-Stammverzeichnis.

• Nutzung: Wie bei MIT sind Forschung, private und kommerzielle Nutzung, Modifikation, Verbreitung und Weiterverkauf erlaubt.

• Bei Verkauf oder kostenpflichtiger Bereitstellung: Wenn diese Software allein verkauft oder in Produkte/Dienste integriert verkauft wird, müssen Urheberrechtshinweis und dieser Lizenztext in den an Endnutzer übermittelten Materialien (Dokumentation, Kredit-/Lizenzbildschirme, Paketmetadaten usw.) enthalten sein.

Diese Anleitung ist eine Zusammenfassung; rechtlich verbindlich ist der Originaltext der LICENSE.

Mitwirkung

Issues & PRs sind immer willkommen. Rechtsdomänendaten, Verbesserungen der Suchqualität und neue MCP-Tool-Ideen sind alle willkommen.

LexGuard MCP — Wir helfen Ihnen, den Einstieg in rechtliche Informationen zu finden. Das Gesetz ist schwierig, aber der erste Anhaltspunkt kann leicht sein.