Korean Law ALIO MCP

An MCP for searching, comparing, and analyzing internal regulations of public institutions from the National Law Information Center and ALIO.

Analysis is performed by a total of 110 MCP tools: 87 from the Ministry of Government Legislation + 23 from ALIO public institution regulations.

It helps AI generate high-quality answers by searching, comparing, and analyzing 1,600 laws, 10,000 administrative rules, tens of thousands of precedents, and 35,000 internal regulations from 344 public institutions.

This project is a fork of chrisryugj/korean-law-mcp.

English

Why I Created This

I have found korean-law-mcp to be very helpful for public institution operations regarding general laws. Once again, I would like to thank chrisryugj.

I believed that incorporating internal regulations of public institutions would yield even greater results. Therefore, I conducted additional development by referencing internal regulation data from ALIO.

I hope this will be helpful to those who find it difficult to access laws and to public institution employees across the country who struggle with managing internal regulations.

Related MCP server: korean-privacy-law-mcp

v1.0.0 — Public Institution Regulations and Ministry of Government Legislation Laws at Once

Integrating 23 ALIO public institution tools + 3 linkage tools connecting the two domains on top of the original 87 Ministry of Government Legislation tools — 110 tools search, compare, and analyze 1.27GB of data (Ministry of Government Legislation + 35,000 public institution internal regulations) using natural language.

Additional Developments

• 23 ALIO Tools — Integration of 35,000 internal regulations from 344 public institutions (automatic conversion of HWP/HWPX/PDF/XLSX via kordoc integrated parser, on-demand disk reading)

• 3 Types of Linkage Tools Connecting Public Institution Regulations and Ministry of Government Legislation Laws

  • Automatic extraction of higher-level laws cited in public institution regulations + automatic lookup of each law's information from the Ministry of Government Legislation

  • Reverse search of public institution regulations nationwide that are based on a specific law when provided with a Ministry of Government Legislation law

  • Automatic analysis of how articles cite and reference each other within a single regulation

• Natural Language Routing — Automatic lookup of official institution names (synchronous loading of institutions.json), automatic branching to both domains

• Clear Guidance on API Key Authentication Failure — Unified integration of 12 fetch sites, guidance to registration page if IP/domain whitelist is blocked

• Setup Wizard — npx korean-law-alio-mcp setup (API key → operation mode → multi-client selection → automatic configuration registration)

• Remote Deployment on fly.io — https://korean-law-alio-mcp.fly.dev (110 tools + ALIO data mirror, best-effort updates)

• CLI Surface Cleanup — list/help/--category/explain/REPL + natural language bare-query

• 168 Cases Test Suite — build 6 + router 13 + cli 23 + alio 39 + law 87 (npm test)

• License Hygiene — 4 files rewritten in clean-room, 0 BSL/Source-Available code

Example — Natural Language Query Connecting Both Domains

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

→ When the AI receives a natural language query, it automatically performs the following:

• Analyzes the text of the institution's personnel regulations to automatically extract cited higher-level laws

• Automatically looks up and attaches the identifier for each extracted law from the Ministry of Government Legislation OpenAPI

• Matches internal higher-level regulations of the same institution

Result Example:

"I found about 10 citations of higher-level laws in the personnel regulation text (e.g., general laws related to personnel/labor, safety/health, gender equality, etc.). The identifier for each law is attached for follow-up lookup. Internal higher-level regulations of the same institution were also matched."

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

→ When the AI receives a natural language query, it automatically performs the following:

• Reverse searches for citation locations of the relevant law (e.g., Labor Standards Act) in the text of 35,000 public institution regulations

• Organizes the citation context of the matched guidelines (which article is cited and how)

• Displays by institution group

Result Example:

"Instances of citations for the relevant law were detected in several public institution guidelines. You can compare how each guideline cites which article to review the compliance level of your own institution's guidelines."

Track everything from public institution compliance reviews and audits to policy analysis and higher-level laws at once.

Installation and Usage

Step 0: Issue API Key (Free, 1 minute)

First, obtain the Ministry of Government Legislation Open API Authentication Key (OC), which is required for all methods.

1. Access the Ministry of Government Legislation Open API Application Page

2. Sign up and log in

3. Click the "Apply for Open API Use" button

4. Fill out the application form → Issue Authentication Key (OC) (email ID format)

your-api-key-here in all examples below is a placeholder — replace it with your issued key. (Same convention as .env.example)

Method 1: Claude Code Plugin — One-line Installation

If you export your API key as an environment variable first, it will be automatically injected during installation.

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

Then, inside Claude Code:

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

After installation, npx -y korean-law-alio-mcp is automatically executed and LAW_OC is passed. No need to edit separate configuration files.

Method 2: Use Directly on Claude.ai Web (No Installation) — Easiest

Add a custom connector on claude.ai. Requires Claude Pro/Max/Team/Enterprise plan (Free only allows 1 connector).

How to add a connector:

1. Log in to claude.ai

2. Your name at the bottom of the sidebar → "Settings" → "Connectors"

3. "Custom Connectors" area → "Add custom connector"

4. Enter the following (replace your-api-key-here with your own key):

   • Name: korean-law-alio (optional)

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

5. "Add" → Registration complete

Enable Tools (Important): Click "Configure" on the registered connector → Set all tools to "Always allow" in the tool list. The AI can call them immediately without approval every time.

Now, in chat, use natural language:

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

ALIO data is updated periodically by the operator, but since ALIO does not provide a separate API, real-time updates are difficult (periodic updates are planned).

Method 3: Use in AI Desktop Apps (Claude Desktop · Cursor · Windsurf)

Add the following to your configuration file:

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

Configuration file location:

If other MCP servers are already configured, just add the "korean-law-alio": { ... } part inside "mcpServers": { ... }. Save and restart the app.

Method 4: Install Directly on Your Computer (Offline Possible)

You can install it directly if you want to use it without the internet or avoid going through a remote server.

Prerequisites: Node.js version 20 or higher.

Automatic Installation (Recommended):

npx korean-law-alio-mcp setup

The installation wizard handles everything from API key entry → AI client selection → automatic configuration file registration at once. Supports Claude Desktop, Claude Code, Cursor, VS Code, and Windsurf.

Manual Installation:

npm install -g korean-law-alio-mcp

Add the following to your AI app configuration file (replace your-api-key-here with your own authentication key):

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

Prepare ALIO Data — To use ALIO tools on your PC, you need data. Prepare it using one of two methods.

(Method 1) Use Operator Mirror (5-15 minutes, recommended)

Download pre-collected data. Approximately 200MB compressed → 1.27GB when extracted.

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\

(Method 2) Collect Yourself (6-12 hours)

Collect 35,000 regulations from 344 public institutions directly from ALIO disclosures. You can control the latest data yourself.

Installing OS system tools is recommended for converting some special cases like scanned PDF/HWP 3.0 (general cases are processed normally even without them, only special cases are skipped).

The HWP/HWPX/PDF integrated parser (kordoc) is automatically installed during npm install. No separate installation is required, and parts that are difficult to parse with kordoc are additionally parsed using docling · tesseract · tesseract-lang · libreoffice.

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 is enough for collection itself (special cases are skipped). If you don't have Node.js, download and install the LTS version (20+) .msi from nodejs.org.

Once the programs required for parsing are installed, collect with the following command.

Collection command:

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

Collected data is saved in data/alio/ (approx. 1.27GB).

Restart the app and you're done!

Method 5: Use Directly in Terminal (CLI)

If you are a developer, you can search for laws and public institution regulations directly in the terminal.

# 설치
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 (대화형)

ALIO tools use user natural language as is — comparison target institutions are not hardcoded in environment variables. If you express it freely like "Compare with A, B, C institutions", "random", or "all", the LLM will call it automatically.

Summary of API Key Delivery Methods

Authentication keys can be delivered in several ways. They are applied in order of priority from top to bottom:

Usage Examples

Ministry of Government Legislation Tools — Laws, Precedents, Interpretations

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

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

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

ALIO Public Institution Regulation Tools

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

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

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

Tools Connecting Ministry of Government Legislation and ALIO

Public institution internal regulations are essentially delegated/based on higher-level Ministry of Government Legislation laws. Natural language queries connecting the two domains are also handled automatically:

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

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

Tool Structure (110)

Refer to docs/API.md for full tool details (names, parameters, examples).

Key Features

• 110 Tools Integrated — 87 Ministry of Government Legislation + 23 ALIO Public Institutions

• Linkage Between Two Domains — Automatic extraction of cited laws in public institution regulations + ALIO reverse search based on higher-level laws + citation graph between articles

• Natural Language Routing — Automatic matching of official institution names (344 collected institutions), automatic branching between two domains

• MCP + CLI — Use the same tools in Claude Desktop·Cursor·Windsurf and in the terminal

• Legal Domain Specialization — Automatic recognition of abbreviations (화관법 → Chemicals Control Act), article number conversion (제38조 ↔ 003800), visualization of delegation structure

• Text Extraction from Tables/Forms — Automatic conversion of HWPX·HWP·PDF·XLSX·DOCX (kordoc engine)

• Remote + Local Mode — Immediate use of https://korean-law-alio-mcp.fly.dev OR keep data on your PC (npm run alio:sync)

• Automatic Setup Wizard — npx korean-law-alio-mcp setup

• Verification — 168 cases automatic testing (npm test — build, router, CLI, ALIO, Ministry of Government Legislation)

• License — MIT

Environment Variables

Refer to .env.example for all variables + examples.

Documentation

Acknowledgments

This project was made possible thanks to the following people:

• chrisryugj — This project could not have started without the korean-law-mcp and kordoc projects. Thank you sincerely.

• jkg — Thank you for the idea of integrating ALIO public institution internal regulations.

License

MIT

Made by scvcoder