Korean Law ALIO MCP

Dies ist ein MCP zum Suchen, Vergleichen und Analysieren von nationalen Rechtsinformationen und internen Vorschriften öffentlicher Einrichtungen von ALIO.

Insgesamt 110 MCP-Tools, bestehend aus 87 Tools des Ministeriums für Gesetzgebung und 23 Tools für ALIO-Vorschriften öffentlicher Einrichtungen, führen die Analyse durch.

Es hilft der KI, bessere Antworten zu generieren, indem es 1.600 Gesetze, 10.000 Verwaltungsvorschriften, zehntausende Präzedenzfälle und 35.000 interne Vorschriften von 344 öffentlichen Einrichtungen durchsucht, vergleicht und analysiert.

Dieses Projekt wurde als Ableger von chrisryugj/korean-law-mcp entwickelt.

Englisch

Beweggründe

Die Arbeit mit den gesamten Rechtsvorschriften wird durch die Hilfe von korean-law-mcp bei der täglichen Arbeit in öffentlichen Einrichtungen sehr erleichtert. Nochmals vielen Dank an chrisryugj.

Ich war der Meinung, dass die Einbeziehung der internen Vorschriften öffentlicher Einrichtungen einen noch größeren Nutzen bringen würde. Daher habe ich das Projekt unter Einbeziehung der Daten zu internen Vorschriften öffentlicher Einrichtungen von ALIO weiterentwickelt.

Ich hoffe, dass dies Menschen, die Schwierigkeiten beim Zugang zu Gesetzen haben, sowie Mitarbeitern öffentlicher Einrichtungen im ganzen Land, die mit der Verwaltung interner Vorschriften zu kämpfen haben, eine Hilfe ist.

v1.0.0 — Vorschriften öffentlicher Einrichtungen und Gesetze des Ministeriums für Gesetzgebung auf einen Blick

Integration von 23 ALIO-Tools für öffentliche Einrichtungen + 3 Verbindungstools zwischen beiden Bereichen zu den ursprünglichen 87 Tools des Ministeriums für Gesetzgebung — 110 Tools durchsuchen, vergleichen und analysieren 1,27 GB an Daten (Ministerium für Gesetzgebung + 35.000 interne Vorschriften öffentlicher Einrichtungen) mittels natürlicher Sprache.

Zusätzliche Entwicklungen

• 23 ALIO-Tools — Integration von 35.000 internen Vorschriften von 344 öffentlichen Einrichtungen (automatische Konvertierung von HWP/HWPX/PDF/XLSX mittels kordoc-Integrationsparser, On-Demand-Festplattenzugriff)

• 3 Arten von Verbindungstools zwischen Vorschriften öffentlicher Einrichtungen und Gesetzen des Ministeriums für Gesetzgebung

  • Automatische Extraktion der in Vorschriften öffentlicher Einrichtungen zitierten übergeordneten Gesetze + automatische Abfrage der jeweiligen Gesetzesinformationen beim Ministerium für Gesetzgebung

  • Rückwärtssuche nach Vorschriften öffentlicher Einrichtungen im ganzen Land, die auf einem vom Benutzer eingegebenen Gesetz des Ministeriums für Gesetzgebung basieren

  • Automatische Analyse, wie Artikel innerhalb einer einzelnen Vorschrift zitiert und referenziert werden

• Routing in natürlicher Sprache — Automatische Suche nach offiziellen Einrichtungsnamen (Laden von institutions.json), automatische Verzweigung in beide Bereiche

• Klare Hinweise bei Fehlern der API-Schlüssel-Authentifizierung — Zusammenführung von 12 Fetch-Seiten, Anleitung zur Registrierungsseite bei IP/Domain-Whitelist-Blockierung

• Setup-Assistent — npx korean-law-alio-mcp setup (API-Schlüssel → Betriebsmodus → Mehrfachauswahl von Clients → automatische Registrierung der Einstellungen)

• Remote-Bereitstellung via fly.io — https://korean-law-alio-mcp.fly.dev (110 Tools + ALIO-Daten-Mirror, Best-Effort-Aktualisierung)

• Bereinigung der CLI-Oberfläche — list/help/--category/explain/REPL + Bare-Query in natürlicher Sprache

• Test-Suite mit 168 Fällen — Build 6 + Router 13 + CLI 23 + ALIO 39 + Gesetz 87 (npm test)

• Lizenzhygiene — 4 Dateien im Clean-Room neu geschrieben, 0 BSL/Source-Available-Code

Beispiel — Abfrage in natürlicher Sprache, die beide Bereiche verbindet

"OO진흥원 인사규정과 관련된 상위 법령을 알려줘"

→ Wenn die KI eine Abfrage in natürlicher Sprache erhält, führt sie automatisch Folgendes aus:

• Analyse des Textes der Personalvorschriften der jeweiligen Einrichtung zur automatischen Extraktion der zitierten übergeordneten Gesetze

• Automatische Abfrage und Anhängen der Kennung jedes extrahierten Gesetzes über die OpenAPI des Ministeriums für Gesetzgebung

• Abgleich mit internen übergeordneten Vorschriften derselben Einrichtung

Ergebnisbeispiel:

"Ich habe etwa 10 Zitate übergeordneter Gesetze im Text der Personalvorschriften gefunden (z. B. allgemeine Gesetze zu Personal/Arbeit, Gesetze zu Sicherheit/Gesundheit, Gesetze zur Gleichstellung der Geschlechter usw.). Die Kennung jedes Gesetzes ist beigefügt, um eine nachfolgende Abfrage zu ermöglichen. Interne übergeordnete Vorschriften derselben Einrichtung wurden ebenfalls abgeglichen."

"OO공단의 OOO지침이 근로기준법을 준수하는지 검토해줘"

→ Wenn die KI eine Abfrage in natürlicher Sprache erhält, führt sie automatisch Folgendes aus:

• Rückwärtssuche nach Zitierstellen des jeweiligen Gesetzes (z. B. Arbeitsnormengesetz) in den Texten der 35.000 Vorschriften öffentlicher Einrichtungen

• Zusammenfassung des Zitatkontexts der abgeglichenen Richtlinien (welcher Artikel wie zitiert wurde)

• Anzeige gruppiert nach Einrichtungen

Ergebnisbeispiel:

"Es wurden Zitatbeispiele des betreffenden Gesetzes in mehreren Richtlinien öffentlicher Einrichtungen gefunden. Durch den Vergleich, welcher Artikel von welcher Richtlinie wie zitiert wird, können Sie den Compliance-Grad der Richtlinien Ihrer eigenen Einrichtung überprüfen."

Verfolgung von der Compliance-Prüfung öffentlicher Einrichtungen, Audits und Politikanalysen bis hin zu übergeordneten Gesetzen auf einen Schlag.

Installation und Verwendung

Schritt 0: API-Schlüssel ausstellen (kostenlos, 1 Minute)

Besorgen Sie sich zuerst den Open API-Authentifizierungsschlüssel (OC) des Ministeriums für Gesetzgebung, der für alle Methoden erforderlich ist.

1. Besuchen Sie die Antragsseite für Open API des Ministeriums für Gesetzgebung

2. Nach der Registrierung einloggen

3. Klicken Sie auf die Schaltfläche "Open API-Nutzung beantragen"

4. Antragsformular ausfüllen → Authentifizierungsschlüssel (OC) ausstellen lassen (E-Mail-ID-Format)

your-api-key-here in allen folgenden Beispielen ist ein Platzhalter — ersetzen Sie ihn durch Ihren eigenen Schlüssel. (Gleiche Konvention wie in .env.example)

Methode 1: Claude Code Plugin — Installation mit einer Zeile

Wenn Sie Ihren API-Schlüssel vorab als Umgebungsvariable exportieren, wird er bei der Installation automatisch eingefügt.

export LAW_OC=your-api-key-here   # ~/.zshrc 또는 ~/.bashrc 에 추가하면 영구 적용

Danach innerhalb von Claude Code:

/plugin marketplace add scvcoder/korean-law-alio-mcp
/plugin install korean-law-alio@korean-law-alio-marketplace

Nach der Installation wird automatisch npx -y korean-law-alio-mcp ausgeführt und LAW_OC übergeben. Es ist keine Bearbeitung von Konfigurationsdateien erforderlich.

Methode 2: Direkte Verwendung auf Claude.ai Web (keine Installation) am einfachsten

Fügen Sie einen benutzerdefinierten Connector auf claude.ai hinzu. Erfordert ein Claude Pro/Max/Team/Enterprise-Abonnement (Free erlaubt nur 1 Connector).

So fügen Sie einen Connector hinzu:

1. Bei claude.ai einloggen

2. Unten in der Seitenleiste auf Ihren Namen → "Einstellungen" → "Connectors"

3. Bereich "Benutzerdefinierte Connectors" → "Benutzerdefinierten Connector hinzufügen"

4. Folgendes eingeben (your-api-key-here durch Ihren eigenen Schlüssel ersetzen):

   • Name: korean-law-alio (frei wählbar)

   • URL: https://korean-law-alio-mcp.fly.dev/mcp?oc=your-api-key-here

5. "Hinzufügen" → Registrierung abgeschlossen

Tools aktivieren (wichtig): Klicken Sie auf "Konfigurieren" des registrierten Connectors → Stellen Sie in der Tool-Liste alle Tools auf "Immer verwenden". Die KI kann sie sofort ohne jedes Mal erneute Genehmigung aufrufen.

Jetzt im Chat in natürlicher Sprache:

"근로기준법 제74조 알려줘"                              → 법제처 87개 도구
"○○진흥원 인사규정 알려줘"                              → ALIO 23개 도구
"○○진흥원 감사규정과 관련된 상위법령은 뭐니?"          → 규정→법령 연계
"근로기준법과 OO공단의 인사규정의 관계는 어떻게 되니?"  → 법령→규정 역검색
"공공기관 휴직 규정 비교해줘"                            → ALIO 기관간 토픽 비교

Die ALIO-Daten werden vom Betreiber regelmäßig aktualisiert, aber da ALIO keine separate API bereitstellt, ist eine Echtzeit-Aktualisierung schwierig (regelmäßige Updates geplant).

Methode 3: Verwendung in AI-Desktop-Apps (Claude Desktop · Cursor · Windsurf)

Fügen Sie der Konfigurationsdatei Folgendes hinzu:

{
  "mcpServers": {
    "korean-law-alio": {
      "url": "https://korean-law-alio-mcp.fly.dev/mcp?oc=your-api-key-here"
    }
  }
}

Speicherort der Konfigurationsdatei:

Wenn bereits andere MCP-Server konfiguriert sind, fügen Sie nur den Teil "korean-law-alio": { ... } innerhalb von "mcpServers": { ... } hinzu. Nach dem Speichern die App neu starten.

Methode 4: Direkte Installation auf Ihrem Computer (offline möglich)

Wenn Sie ohne Internet arbeiten möchten oder keinen Remote-Server nutzen wollen, können Sie es direkt installieren.

Vorbereitung: Node.js Version 20 oder höher.

Automatische Installation (empfohlen):

npx korean-law-alio-mcp setup

Der Installationsassistent erledigt die Eingabe des API-Schlüssels, die Auswahl des KI-Clients und die automatische Registrierung der Konfigurationsdatei in einem Schritt. Unterstützt Claude Desktop, Claude Code, Cursor, VS Code und Windsurf.

Manuelle Installation:

npm install -g korean-law-alio-mcp

Fügen Sie der Konfigurationsdatei der KI-App Folgendes hinzu (ersetzen Sie your-api-key-here durch Ihren eigenen Authentifizierungsschlüssel):

{
  "mcpServers": {
    "korean-law-alio": {
      "command": "korean-law-alio-mcp",
      "env": {
        "LAW_OC": "your-api-key-here"
      }
    }
  }
}

ALIO-Daten vorbereiten — Um die ALIO-Tools auf Ihrem PC zu nutzen, benötigen Sie Daten. Bereiten Sie diese auf eine der beiden Arten vor.

(Methode 1) Verwendung des Mirror-Servers des Betreibers (5-15 Minuten, empfohlen)

Laden Sie die vorab gesammelten Daten herunter. Ca. 200 MB komprimiert → 1,27 GB nach dem Entpacken.

Mac, Linux:

curl -L -o alio-data.tar.gz https://github.com/scvcoder/korean-law-alio-mcp/releases/latest/download/alio-data.tar.gz
tar -xzf alio-data.tar.gz -C data/

Windows (PowerShell):

Invoke-WebRequest -Uri https://github.com/scvcoder/korean-law-alio-mcp/releases/latest/download/alio-data.zip -OutFile alio-data.zip
Expand-Archive -Path alio-data.zip -DestinationPath data\

(Methode 2) Selbst sammeln (6-12 Stunden)

Sammeln Sie die 35.000 Vorschriften von 344 öffentlichen Einrichtungen direkt aus der ALIO-Offenlegung. Sie haben die volle Kontrolle über die aktuellsten Daten.

Für die Konvertierung einiger spezieller Fälle wie gescannte PDFs oder HWP 3.0 wird die Installation von OS-Systemtools empfohlen (auch ohne diese funktionieren normale Fälle einwandfrei, nur Spezialfälle werden übersprungen).

Der HWP/HWPX/PDF-Integrationsparser (kordoc) wird bei npm install automatisch installiert. Eine separate Installation ist nicht erforderlich. Teile, die mit kordoc schwer zu parsen sind, werden zusätzlich mit docling · tesseract · tesseract-lang · libreoffice geparst.

macOS:

brew install docling tesseract tesseract-lang libreoffice

Linux (Ubuntu/Debian):

sudo apt install tesseract-ocr tesseract-ocr-kor libreoffice
pip install docling

Windows: Node.js reicht aus, damit die Sammlung selbst funktioniert (Spezialfälle werden übersprungen). Falls kein Node.js vorhanden ist, laden Sie die LTS-Version (20 oder höher) von nodejs.org als .msi herunter und installieren Sie sie.

Wenn die für das Parsen erforderlichen Programme installiert sind, sammeln Sie die Daten mit dem folgenden Befehl.

Sammelbefehl:

npm run alio:sync                   # 전체 344개 기관 (6-12시간)
npm run alio:sync -- --only C0xxx   # 단일 기관만 (apbaId 4자리, 수 분)
npm run alio:sync -- --resume       # 실패한 기관만 재시도

Die gesammelten Daten werden unter data/alio/ gespeichert (ca. 1,27 GB).

Starten Sie die App neu und fertig!

Methode 5: Direkte Verwendung im Terminal (CLI)

Als Entwickler können Sie Gesetze und Vorschriften öffentlicher Einrichtungen direkt im Terminal durchsuchen.

# 설치
npm install -g korean-law-alio-mcp

# 인증키 설정 (your-api-key-here 를 본인 키로 바꾸세요)
export LAW_OC=your-api-key-here     # Mac/Linux
set LAW_OC=your-api-key-here        # Windows CMD
$env:LAW_OC="your-api-key-here"    # Windows PowerShell

# 사용 예시
korean-law-alio "민법 제1조"                                # 법제처 자연어
korean-law-alio "OO진흥원 인사규정"                         # ALIO 자연어
korean-law-alio "OO진흥원 인사규정과 관련된 상위 법령"      # 두 영역 연계
korean-law-alio "공공기관 휴직 규정 비교해줘"                # ALIO 기관간 비교
korean-law-alio search_law --query "관세법"                 # 도구 직접 호출
korean-law-alio list                                        # 전체 110개 도구 목록
korean-law-alio list --category ALIO                        # 카테고리별 (ALIO/판례/법령검색 등)
korean-law-alio help search_law                             # 도구별 도움말
korean-law-alio                                             # REPL (대화형)

Die ALIO-Tools verstehen die natürliche Sprache des Benutzers — die zu vergleichende Einrichtung muss nicht in einer Umgebungsvariablen festgeschrieben sein. Wenn Sie "Vergleich mit Einrichtung A, B, C", "zufällig" oder "alle" frei ausdrücken, ruft das LLM sie automatisch auf.

Zusammenfassung der Methoden zur Übergabe des API-Schlüssels

Sie können den Authentifizierungsschlüssel auf verschiedene Weise übergeben. Die Priorität ist von oben nach unten:

Anwendungsbeispiele

Tools des Ministeriums für Gesetzgebung — Gesetze, Präzedenzfälle, Interpretationen

"민법 제1조 알려줘"
→ AI 가 법령 검색 → 해당 조문 자동 조회

"음주운전 처벌 기준"
→ AI 가 관련 법령 + 판례 + 해석례를 자동으로 종합 분석

"근로기준법 제74조 해석례"
→ AI 가 해당 조문 + 정부 해석례를 자동 매칭

Tools für ALIO-Vorschriften öffentlicher Einrichtungen

"OO진흥원 인사규정 보여줘"
→ AI 가 정식 기관명을 자동 매칭 → 해당 기관 규정 목록 표시

"공공기관 휴직 규정 비교해줘"
→ AI 가 수집된 공공기관 전체에서 휴직 관련 규정을 자동 비교

"우리 기관에 없는 동종 기관 규정"
→ AI 가 동종 기관 보유 규정 - 자기 기관 보유 규정 = 벤치마킹 후보 자동 추출

Tools zur Verbindung von Ministerium für Gesetzgebung und ALIO

Interne Vorschriften öffentlicher Einrichtungen basieren im Wesentlichen auf einer Delegation/Grundlage durch übergeordnete Gesetze des Ministeriums für Gesetzgebung. Abfragen in natürlicher Sprache, die beide Bereiche verbinden, werden ebenfalls automatisch verarbeitet:

"OO진흥원 인사규정과 관련된 상위 법령을 알려줘"
→ AI 가 규정 본문에서 인용된 상위 법령을 자동 추출
   + 법제처에서 각 법령 정보를 자동 조회

"OO공단의 OOO지침이 근로기준법을 준수하는지 검토해줘"
→ AI 가 35,000건 공공기관 규정에서 해당 법령 인용 위치를 역검색
   → 매칭된 지침의 인용 컨텍스트 + 기관별 그룹 표시

Tool-Struktur (110 Tools)

Details zu allen Tools (Name, Parameter, Beispiele) finden Sie in docs/API.md.

Hauptmerkmale

• Integration von 110 Tools — 87 vom Ministerium für Gesetzgebung + 23 ALIO-Tools für öffentliche Einrichtungen

• Verknüpfung beider Bereiche — Automatische Extraktion zitierter Gesetze aus Vorschriften öffentlicher Einrichtungen + ALIO-Rückwärtssuche basierend auf übergeordnetem Recht + Zitatgraph zwischen Artikeln

• Routing in natürlicher Sprache — Automatische Zuordnung offizieller Einrichtungsnamen (344 gesammelte Einrichtungen), automatische Verzweigung zwischen beiden Bereichen

• MCP + CLI — Gleiche Tools in Claude Desktop, Cursor, Windsurf und im Terminal

• Spezialisierung auf Rechtsdomäne — Automatische Erkennung von Abkürzungen (화관법 → 화학물질관리법), Artikelnummernkonvertierung (제38조 ↔ 003800), Visualisierung der Delegationsstruktur

• Extraktion von Anhängen/Formularen — Automatische Konvertierung von HWPX, HWP, PDF, XLSX, DOCX (kordoc-Engine)

• Remote- + Lokal-Modus — Sofortige Nutzung von https://korean-law-alio-mcp.fly.dev ODER Speicherung der Daten auf dem eigenen PC (npm run alio:sync)

• Automatischer Installationsassistent — npx korean-law-alio-mcp setup

• Validierung — Automatisierte Tests für 168 Fälle (npm test — Build, Router, CLI, ALIO, Ministerium für Gesetzgebung)

• Lizenz — MIT

Umgebungsvariablen

Alle Variablen + Beispiele finden Sie in .env.example.

Dokumentation

Danksagung

Dieses Projekt wurde durch folgende Personen ermöglicht:

• chrisryugj — Ohne die Projekte korean-law-mcp und kordoc hätte dieses Projekt nicht gestartet werden können. Vielen herzlichen Dank.

• jkg — Danke für die Idee, die internen Vorschriften öffentlicher Einrichtungen von ALIO zu integrieren.

Lizenz

MIT

Made by scvcoder