韓国法 ALIO MCP

国家法令情報センターとALIO（公共機関経営情報公開システム）の公共機関内部規定を検索・比較・分析するMCPです。

法制処の87個のツールとALIO公共機関規定の23個、合計110個のMCPツールが分析を行います。

1,600の法律、10,000の行政規則、数万件の判例、344の公共機関の35,000の内部規定を検索・比較・分析した結果をAIに提供し、より良い回答を作成できるよう支援します。

本プロジェクトは chrisryugj/korean-law-mcp から派生して作成されました。

English

作成の理由

全法令に対して korean-law-mcp の助けを借りて、公共機関の業務処理に非常に役立てています。改めて chrisryugj 様に感謝いたします。

ここに公共機関の内部規定まで活用できれば、さらに大きな効果があると考えました。そのため、ALIO の公共機関内部規定データを参考に、追加開発を行うことになりました。

法へのアクセスが難しい方々や、内部規定の管理に苦労している全国の公共機関職員の皆様の助けになれば幸いです。

v1.0.0 — 公共機関の規定と法制処の法令を一度に

原作の87個の法制処ツールに加え、ALIO公共機関の23個のツール + 両領域をつなぐ連携ツール3個 を統合 — 110個のツールが1.27GBのデータ（法制処 + 35,000件の公共機関内部規定）を自然言語で検索・比較・分析します。

追加開発事項

• ALIO 23個のツール — 344の公共機関の35,000件の内部規定を統合（kordoc統合パーサーによるHWP/HWPX/PDF/XLSXの自動変換、オンデマンドディスク読み込み）

• 公共機関の規定と法制処の法令をつなぐ連携ツール3種

  • 公共機関の規定で引用された上位法令を自動抽出 + 法制処から各法令情報を自動照会

  • 法制処の法令を入力すると、その法令を根拠とする公共機関の規定を全国から逆検索

  • 単一規定内で条文同士がどのように引用・参照されているかを自動分析

• 自然言語ルーティング — 正式機関名の自動ルックアップ（institutions.jsonの同期読み込み）、両領域への自動分岐

• APIキー認証失敗の明確な案内 — 12個のfetchサイトを一括統合、IP/ドメインホワイトリスト遮断時の登録ページ案内

• セットアップウィザード — npx korean-law-alio-mcp setup (APIキー → 運用モード → クライアント複数選択 → 設定自動登録)

• fly.io リモートデプロイ — https://korean-law-alio-mcp.fly.dev (110個のツール + ALIOデータミラー、ベストエフォート更新)

• CLIインターフェースの整理 — list/help/--category/explain/REPL + 自然言語bare-query

• 168 cases テストスイート — build 6 + router 13 + cli 23 + alio 39 + law 87 (npm test)

• ライセンス衛生 — 4つのファイルをクリーンルームで再作成、BSL/Source-Availableコード0

例 — 両領域をつなぐ自然言語クエリ

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

→ AIが自然言語クエリを受け取ると、自動的に以下を実行：

• 当該機関の人事規定本文を分析し、引用された上位法令を自動抽出

• 抽出された各法令の識別子を法制処OpenAPIから自動照会して添付

• 同一機関の内部上位規定も併せてマッチング

結果例：

"人事規定本文から約10件の上位法令の引用を見つけました（例：人事・勤労関連一般法令、安全・保健関連法令、男女平等関連法令など）。各法令の識別子が添付されており、後続の照会が可能です。同一機関の内部上位規定も併せてマッチングされました。"

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

→ AIが自然言語クエリを受け取ると、自動的に以下を実行：

• 35,000件の公共機関規定本文から、当該法令（例：勤労基準法）の引用位置を逆検索

• マッチングされた指針の引用コンテキスト（どの条文がどのように引用されたか）を整理

• 機関別グループで表示

結果例：

"複数の公共機関の指針から、当該法令の引用事例が検出されました。各指針がどの条文をどのように引用しているかを比較し、自機関の指針の遵守レベルを検討できます。"

公共機関のコンプライアンス検討、監査、政策分析において、上位法令まで一度に追跡。

インストールおよび使用方法

ステップ0：APIキーの発行（無料、1分）

すべての方法で共通して必要な 法制処Open API認証キー(OC) を先に発行してください。

1. 法制処Open API申請ページ にアクセス

2. 会員登録後、ログイン

3. "Open API使用申請" ボタンをクリック

4. 申請書作成 → 認証キー(OC) 発行（メールID形式）

下記のすべての例の your-api-key-here はプレースホルダーです — ご自身で発行したキーに置き換えてください。(.env.example と同一のコンベンション)

方法1：Claude Codeプラグイン — 1行インストール

ご自身のAPIキーを先に環境変数としてexportしておくと、インストール時に自動注入されます。

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

その後、Claude Code内で：

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

インストール後、自動的に npx -y korean-law-alio-mcp が実行され、LAW_OC が渡されます。別途設定ファイルの編集は不要です。

方法2：Claude.aiウェブで直接使用（インストール不要）最も簡単

claude.ai でカスタムコネクタを追加。Claude Pro/Max/Team/Enterpriseプランが必要（Freeプランはコネクタ1つのみ可能）。

コネクタ追加方法：

1. claude.aiにログイン

2. サイドバー下部の名前 → "設定" → "コネクタ"

3. "カスタムコネクタ"領域 → "カスタムコネクタを追加"

4. 以下を入力（your-api-key-here はご自身のキーに置き換え）：

   • 名前: korean-law-alio (任意)

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

5. "追加" → 登録完了

ツール有効化（重要）：登録したコネクタの"構成"をクリック → ツールリストから すべてのツールを"常に使用" に設定。毎回承認することなく、AIが直接呼び出し可能。

これでチャットで自然言語を使って：

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

ALIOデータは運営者が定期的に更新しますが、ALIO側で別途APIを提供していないため、リアルタイムでの最新維持は困難です（定期的なアップデートを予定）。

方法3：AIデスクトップアプリで使用（Claude Desktop · Cursor · Windsurf）

設定ファイルに以下の内容を追加：

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

設定ファイルの場所：

すでに他のMCPサーバーが設定されている場合は、"mcpServers": { ... } の中に "korean-law-alio": { ... } 部分だけを追加。保存後、アプリを再起動。

方法4：自分のコンピュータに直接インストール（オフライン可能）

インターネットなしで使用したい場合や、リモートサーバーを経由したくない場合は、直接インストールできます。

事前準備： Node.js バージョン20以上。

自動インストール（推奨）：

npx korean-law-alio-mcp setup

インストールウィザードがAPIキー入力 → AIクライアント選択 → 設定ファイル自動登録まで一度に行います。 Claude Desktop、Claude Code、Cursor、VS Code、Windsurfをサポートしています。

手動インストール：

npm install -g korean-law-alio-mcp

AIアプリの設定ファイルに以下の内容を追加してください（your-api-key-here をご自身の認証キーに置き換えてください）：

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

ALIOデータの準備 — 自分のPCでALIOツールを使うにはデータが必要です。2つの方法のいずれかで準備してください。

（方法1）運営者のミラーを使用（5-15分、推奨）

あらかじめ収集しておいたデータをダウンロード。約200MBの圧縮版 → 解凍すると1.27GB。

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\

（方法2）直接収集（6-12時間）

ALIO公示から344の公共機関の35,000件の規定を直接収集。最新データを自分で管理可能。

スキャンPDF · HWP 3.0のような一部の特殊ケース変換のために、OSシステムツールのインストールを推奨（なくても一般ケースは正常処理され、特殊ケースのみスキップされます）。

HWP/HWPX/PDF統合パーサー(kordoc)は npm install 時に自動インストールされます。別途インストールは不要で、kordocで解析が困難な部分は 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さえあれば収集自体は動作します（特殊ケースはスキップ）。 Node.jsがない場合は nodejs.org からLTSバージョン(20以上)の .msi をダウンロードしてインストール。

解析に必要なプログラムのインストールが完了したら、以下のコマンドで収集します。

収集コマンド：

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

収集されたデータは data/alio/ に保存されます（約1.27GB）。

アプリを再起動すれば完了！

方法5：ターミナル(CLI)から直接使用

開発者であれば、ターミナルから直接法令・公共機関規定を検索できます。

# 설치
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ツールは ユーザーの自然言語そのまま — 比較対象機関を環境変数に固定しません。「A・B・C機関と比較」、「ランダム」、「全体」のように自由に表現すれば、LLMが判断して呼び出します。

APIキーの渡し方まとめ

複数の方法で認証キーを渡すことができます。上から順に優先適用されます：

使用例

法制処ツール — 法令・判例・解釈例

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

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

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

ALIO公共機関規定ツール

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

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

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

法制処とALIOを接続するツール

公共機関の内部規定は、本質的に上位の法制処法令から委任/根拠を受けています。両領域をつなぐ自然言語クエリも自動処理：

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

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

ツール構造（110個）

全ツールの詳細（名前・パラメータ・例）は docs/API.md を参照。

主な特徴

• 110個のツール統合 — 法制処87 + ALIO公共機関23

• 両領域の連携 — 公共機関規定の引用法令自動抽出 + 上位法に基づくALIO逆検索 + 条文間引用グラフ

• 自然言語ルーティング — 正式機関名の自動マッチング（収集された344機関）、両領域の自動分岐

• MCP + CLI — Claude Desktop・Cursor・Windsurfでも、ターミナルでも同じツールを使用

• 法律ドメイン特化 — 略称の自動認識（化管法 → 化学物質管理法）、条文番号変換（第38条 ↔ 003800）、委任構造の可視化

• 別表・別紙様式本文抽出 — HWPX・HWP・PDF・XLSX・DOCX自動変換（kordocエンジン）

• リモート + ローカルモード — https://korean-law-alio-mcp.fly.dev を即時使用 OR 自分のPCにデータを保管 (npm run alio:sync)

• 自動インストールウィザード — npx korean-law-alio-mcp setup

• 検証 — 168 cases自動テスト (npm test — ビルド・ルーター・CLI・ALIO・法制処)

• ライセンス — MIT

環境変数

全変数 + 例は .env.example を参照。

ドキュメント

感謝の言葉

本プロジェクトは、次の方々のおかげで可能となりました：

• chrisryugj 様 — korean-law-mcp、kordoc プロジェクトを作成されなければ、このプロジェクトは開始できませんでした。心から感謝いたします。

• jkg 様 — ALIO公共機関内部規定を統合してみようというアイデアをいただき、ありがとうございます。

ライセンス

MIT

Made by scvcoder