Korean Law ALIO MCP

An MCP that searches, compares, and analyzes national laws from the National Law Information Center and internal regulations of public institutions from 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 responses by searching, comparing, and analyzing 1,600 laws, 10,000 administrative rules, tens of thousands of judicial 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

With the help of korean-law-mcp, I have found great utility in handling public institution tasks regarding overall legislation. Once again, I thank chrisryugj.

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

I hope this helps people who find it difficult to access laws and public institution employees across the country who struggle with managing internal regulations.

v1.0.0 — Public Institution Regulations and Ministry of Government Legislation 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) in 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

  • 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 a Ministry of Government Legislation law is provided

  • 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 — Batch integration of 12 fetch sites, guidance on registration pages when IP/domain whitelisting is blocked

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

• fly.io Remote Deployment — 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 Two Domains

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

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

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

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

• Matches internal higher-level regulations of the same institution together

Result Example:

"I found about 10 citations of higher-level laws in the body of the personnel regulations (e.g., general laws related to personnel/labor, laws related to safety/health, laws related to 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 AI receives a natural language query, it automatically performs the following:

• Reverse searches the citation locations of the relevant law (e.g., Labor Standards Act) in the body 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 the relevant law being cited 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) required for all methods.

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

2. Sign up and log in

3. Click the "Open API Usage Application" 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

Tool Activation (Important): Click "Configure" for the registered connector → Set all tools to "Always Allow" in the tool list. AI can call them immediately without approval every time.

Now, in chat, use natural language:

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

ALIO data is periodically updated by the operator, but since ALIO does not provide a separate API, real-time updates are difficult (periodic updates 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": { ... }. Restart the app after saving.

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

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

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"
      }
    }
  }
}

ALIO Data Preparation — 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. About 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) Direct Collection (6-12 hours)

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

Installing OS system tools is recommended for conversion of 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 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 or higher) .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 freely like "Compare with A, B, C institutions", "Random", "All", the LLM will call them automatically.

Summary of API Key Delivery Methods

Authentication keys can be delivered in several ways. 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 automatically processed:

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

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

Tool Structure (110 total)

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 Institution

• 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 (화관법 → Chemical Substances Control Act), article number conversion (Article 38 ↔ 003800), visualization of delegation structure

• Body Extraction of 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 Installation Wizard — npx korean-law-alio-mcp setup

• Verification — 168 cases automatic testing (npm test — build·router·cli·alio·gov)

• License — MIT

Environment Variables

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

Documentation

Acknowledgments

This project was 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