⚖️ LexGuard MCP (Rechts-Hinweis)

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

Basierend auf den offiziellen Daten des National Law Information Center (Open Law) bietet er Gesetze, Artikel, Präzedenzfälle, Rechtsauslegungen, Verwaltungsentscheidungen und Entscheidungen des Verfassungsgerichts in einem einheitlichen Frage-Antwort-Fluss.

• MCP Endpoint: https://lexguard-mcp.onrender.com/mcp

• Health Check: https://lexguard-mcp.onrender.com/health

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

Schnelle Verbindung (Copy & Paste)

Wenn Sie nur das Remote-MCP verwenden, können Sie das folgende JSON direkt in Ihre Client-Konfiguration einfügen.

• Cursor: Fügen Sie den Inhalt von examples/cursor-mcp.remote.json in .cursor/mcp.json o.ä. ein.

• Claude Desktop: examples/claude-desktop-mcp.remote.json → in mcpServers der claude_desktop_config.json zusammenführen.

Lokale Ausführung in einer Zeile (Docker): Nach docker compose up --build im Repository-Stammverzeichnis lautet die MCP-URL http://localhost:9099/mcp. (API-Schlüssel: LAW_API_KEY=IhrSchlüssel docker compose up --build)

Statische Metadaten für Marktplätze/Crawler: mcp/manifest.json · Prompt-Index prompts/ · Ressourcen-URI-Anleitung resources/README.md · Cursor-Entwicklungs-Skill .cursor/skills/lexguard-mcp-dev/SKILL.md

Warum LexGuard?

Recht fühlt sich oft fern und kompliziert an, wenn man es braucht. Hohe Kosten, unbekannte Fachbegriffe, eine Struktur, bei der man nicht weiß, wo man anfangen soll.

LexGuard MCP (Rechts-Hinweis) begann mit diesem Problem.

• Benutzer stellen Fragen in natürlicher Sprache.

• Die KI analysiert die Absicht der Frage.

• Sie liefert Hinweise auf Basis von offiziellen Gesetzes- und Präzedenzfalldaten.

Dies ersetzt keine rechtliche Beratung oder Urteilsfindung. Das Ziel ist es lediglich, den ersten Kontakt mit dem Recht weniger schwierig zu gestalten.

Kernfunktionen

MCP Tools

legal_qa_tool — Allgemeine Rechts-QA

Der zentrale Einstiegspunkt für alle rechtlichen Fragen. Mit einer einzigen Frage werden Gesetze, Präzedenzfälle, Auslegungen und Kommissionsentscheidungen parallel durchsucht und zusammengefasst. Für eingeschränkte Suchen (nur Präzedenzfälle, nur Auslegungen) können die jeweiligen spezialisierten Tools verwendet werden.

Fähigkeiten

• Automatische Klassifizierung in 13 Domänen

• Mehrfache Erkennung der Frageabsicht (Intent) und Priorisierung

• Parallele Suche: Gesetz → Präzedenzfall → Auslegung → Komitee

• Filterung nach natürlichsprachlichen Zeitbedingungen (automatische Umwandlung von date_from / date_to)

Eingabeschema

Beispiel-Prompts

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

law_article_tool — Präzise Gesetzesartikelsuche

Fragt spezifische Klauseln direkt ab, wenn Gesetzesname und Artikelnummer bekannt sind. Während legal_qa_tool eine "Suche" ist, ist dieses Tool eine "präzise Abfrage".

Eingabeschema

Beispiel-Prompts

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

law_comparison_tool — Vergleich von Gesetzen (Neu/Alt, Historie, 3-Spalten-Vergleich)

Fragt Vergleiche zwischen altem und neuem Recht, die Historie oder einen 3-Spalten-Vergleich basierend auf dem Gesetzesnamen 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/AGB

Wenn Sie ein Dokument einfügen, werden rechtliche Probleme auf Klauselebene extrahiert und relevante Gesetze/Präzedenzfälle automatisch gesucht.

Eingabeschema

Unterstützte Dokumententypen

• labor — Arbeitsvertrag / Dienstleistungsvertrag

• lease — Mietvertrag

• terms — Nutzungsbedingungen

Beispiel-Prompts

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

health — Server-Statusprüfung

Überprüft, ob der MCP-Server läuft, den Status der API-Key-Konfiguration und die Umgebungsvariablen.

Dedizierte Such-Tools (Eingeschränkte Quellen)

Verwenden Sie diese, wenn Sie nur nach bestimmten Daten suchen möchten, anstatt die integrierte Suche (legal_qa_tool) zu nutzen.

MCP Prompts

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

MCP Resources

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

URI-Schema

Featured Resources (Standardmäßig enthalten)

Wichtige Gesetze wie das Arbeitsnormengesetz, das Zivilgesetzbuch, das Strafgesetzbuch, das Datenschutzgesetz, das Handelsgesetzbuch, das Staatsbeamtengesetz und das Verwaltungsgerichtsgesetz können sofort abgefragt werden.

Installation

Methode 1. Lokal (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

Methode 2. Docker Compose (Empfohlen · fast in einer 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

Methode 3. Docker (nur run)

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

Methode 4. Remote MCP (Hosting-URL)

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "lexguard-mcp": {
      "url": "https://lexguard-mcp.onrender.com/mcp"
    }
  }
}

Cursor (.cursor/mcp.json)

Identisch mit der Datei examples/cursor-mcp.remote.json:

{
  "mcpServers": {
    "lexguard-mcp": {
      "url": "https://lexguard-mcp.onrender.com/mcp"
    }
  }
}

API-Key-Ausstellung

Sie benötigen einen Open API-Schlüssel des National Law Information Center.

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

2. Antrag auf API-Nutzung stellen

3. LAW_API_KEY=IhrSchlüssel in .env setzen

Architektur

Client (Cursor / Claude)
    │ JSON-RPC 2.0 over SSE
    ▼
FastAPI  (/mcp POST)
    │ Rate Limiting (slowapi, 60 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  (172개 엔드포인트)

Such-Pipeline

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

Wichtiger Tech-Stack

Entwicklung

# 테스트 실행
pytest tests/ -v

# 린트
ruff check src/

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

Lizenz

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

• Nutzung: Wie bei MIT ist die Forschung, private und kommerzielle Nutzung, Änderung, Verbreitung und der Weiterverkauf erlaubt.

• Bei Verkauf/kostenpflichtiger Bereitstellung: Wenn Sie diese Software eigenständig verkaufen oder in ein Produkt/einen Dienst integrieren, müssen der Urheberrechtshinweis und dieser Lizenztext in den Materialien enthalten sein, die an den Endbenutzer geliefert werden (Dokumente, Credits/Lizenzbildschirme, Paket-Metadaten etc.).

Dieser Hinweis ist eine Zusammenfassung; die rechtliche Gültigkeit hat der Originaltext der LICENSE.

Beitrag

Issues & PRs sind immer willkommen. Daten für den Rechtsbereich, Verbesserungen der Suchqualität und Ideen für neue MCP-Tools sind herzlich willkommen.

LexGuard MCP — Wir finden den Hinweis zu Ihren Rechtsinformationen. Das Recht ist kompliziert, aber der erste Hinweis kann einfach sein.