Korean Law ALIO MCP

Это MCP для поиска, сравнения и анализа национальных законов (через Национальный центр правовой информации) и внутренних нормативных актов государственных учреждений (через ALIO).

Анализ выполняется с помощью 110 инструментов MCP: 87 инструментов Министерства законодательства + 23 инструмента для нормативных актов государственных учреждений ALIO.

Система помогает ИИ формировать качественные ответы, выполняя поиск, сравнение и анализ 1600 законов, 10 000 административных правил, десятков тысяч судебных прецедентов и 35 000 внутренних нормативных актов 344 государственных учреждений.

Данный проект является производным от chrisryugj/korean-law-mcp.

English

Причина создания

Благодаря korean-law-mcp работа с общим законодательством стала значительно эффективнее для сотрудников государственных учреждений. Еще раз выражаю благодарность chrisryugj.

Я пришел к выводу, что использование внутренних нормативных актов государственных учреждений даст еще больший эффект. Поэтому я начал дополнительную разработку, опираясь на данные внутренних нормативных актов государственных учреждений из ALIO.

Надеюсь, что это поможет людям, которым сложно ориентироваться в законодательстве, а также сотрудникам государственных учреждений по всей стране, которые сталкиваются с трудностями при управлении внутренними нормативными актами.

v1.0.0 — Нормативные акты госучреждений и законодательство Министерства в одном месте

Интеграция 23 инструментов ALIO для госучреждений + 3 связующих инструментов поверх 87 оригинальных инструментов Министерства законодательства — 110 инструментов для поиска, сравнения и анализа 1,27 ГБ данных (законодательство + 35 000 внутренних актов) на естественном языке.

Дополнительные разработки

• 23 инструмента ALIO — интеграция 35 000 внутренних нормативных актов 344 государственных учреждений (автоматическое преобразование HWP/HWPX/PDF/XLSX с помощью интегрированного парсера kordoc, чтение с диска по требованию).

• 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, обновление best-effort).

• Очистка интерфейса CLI — list/help/--category/explain/REPL + bare-query на естественном языке.

• Набор тестов из 168 случаев — build 6 + router 13 + cli 23 + alio 39 + law 87 (npm test).

• Гигиена лицензий — 4 файла переписаны в режиме clean-room, 0 кода BSL/Source-Available.

Пример — запрос на естественном языке, связывающий две области

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

→ Когда ИИ получает запрос на естественном языке, он автоматически выполняет следующее:

• Анализирует текст правил персонала соответствующего учреждения и автоматически извлекает цитируемые вышестоящие законы.

• Автоматически запрашивает идентификатор каждого извлеченного закона через OpenAPI Министерства законодательства и прикрепляет его.

• Сопоставляет внутренние вышестоящие нормативные акты того же учреждения.

Пример результата:

"В тексте правил персонала найдено около 10 цитат вышестоящих законов (например, общие законы о персонале и труде, законы о безопасности и гигиене труда, законы о гендерном равенстве и т.д.). Идентификаторы каждого закона приложены для последующего поиска. Также сопоставлены внутренние вышестоящие акты того же учреждения."

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

→ Когда ИИ получает запрос на естественном языке, он автоматически выполняет следующее:

• Выполняет обратный поиск мест цитирования соответствующего закона (например, Закона о трудовых стандартах) в 35 000 текстах нормативных актов госучреждений.

• Систематизирует контекст цитирования сопоставленных инструкций (какая статья и как цитируется).

• Отображает результаты по группам учреждений.

Пример результата:

"Случаи цитирования данного закона обнаружены в инструкциях нескольких государственных учреждений. Сравнивая, какие статьи и как цитирует каждая инструкция, вы можете проверить уровень соблюдения требований в инструкциях вашего учреждения."

Отслеживание от комплаенс-проверки госучреждений и аудита до вышестоящих законов за один раз.

Установка и использование

Шаг 0: Получение API-ключа (бесплатно, 1 минута)

Сначала получите сертификационный ключ Open API Министерства законодательства (OC), необходимый для всех методов.

1. Перейдите на страницу подачи заявки на Open API Министерства законодательства.

2. Зарегистрируйтесь и войдите в систему.

3. Нажмите кнопку "Open API 사용 신청" (Заявка на использование Open API).

4. Заполните форму → получите сертификационный ключ (OC) (в формате ID электронной почты).

your-api-key-here во всех примерах ниже — это плейсхолдер, замените его на свой ключ. (Та же конвенция, что и в .env.example).

Метод 1: Плагин Claude Code — установка одной строкой

Если вы заранее экспортируете свой API-ключ как переменную окружения, он будет автоматически внедрен при установке.

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 (в бесплатной версии доступен только 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. "Добавить" → регистрация завершена.

Активация инструментов (важно): Нажмите "Настройка" зарегистрированного коннектора → в списке инструментов установите "Всегда использовать" для всех инструментов. ИИ сможет вызывать их сразу без подтверждения каждый раз.

Теперь в чате на естественном языке:

"근로기준법 제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 уже настроены, добавьте только часть "korean-law-alio": { ... } внутри "mcpServers": { ... }. После сохранения перезапустите приложение.

Метод 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 — чтобы использовать инструменты ALIO на своем ПК, вам нужны данные. Подготовьте их одним из двух способов.

(Способ 1) Использование зеркала оператора (5-15 минут, рекомендуется)

Скачивание заранее собранных данных. Около 200 МБ в сжатом виде → 1,27 ГБ после распаковки.

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 часов)

Самостоятельный сбор 35 000 нормативных актов 344 государственных учреждений из публикаций ALIO. Вы сами контролируете актуальность данных.

Рекомендуется установить системные инструменты ОС для преобразования некоторых специальных случаев, таких как сканированные PDF или HWP 3.0 (без них обычные случаи обрабатываются нормально, пропускаются только специальные).

Интегрированный парсер 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 нет, скачайте и установите LTS-версию (20+) с nodejs.org.

После установки необходимых программ для парсинга выполните сбор следующей командой.

Команда сбора:

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

Собранные данные сохраняются в data/alio/ (около 1,27 ГБ).

Перезапустите приложение, и готово!

Метод 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 Министерства законодательства + 23 ALIO.

• Связь двух областей — автоматическое извлечение цитируемых законов из актов госучреждений + обратный поиск ALIO на основе вышестоящего права + граф цитирования между статьями.

• Маршрутизация на естественном языке — автоматическое сопоставление официальных названий учреждений (344 собранных учреждения), автоматическое разделение двух областей.

• MCP + CLI — использование одних и тех же инструментов в Claude Desktop, Cursor, Windsurf и в терминале.

• Специализация на правовом домене — автоматическое распознавание сокращений (화관법 → 화학물질관리법), преобразование номеров статей (제38조 ↔ 003800), визуализация структуры делегирования.

• Извлечение текста из таблиц и приложений — автоматическое преобразование HWPX, HWP, PDF, XLSX, DOCX (движок kordoc).

• Удаленный + локальный режим — немедленное использование https://korean-law-alio-mcp.fly.dev ИЛИ хранение данных на своем ПК (npm run alio:sync).

• Мастер автоматической установки — npx korean-law-alio-mcp setup.

• Верификация — автоматическое тестирование 168 случаев (npm test — сборка, маршрутизатор, CLI, ALIO, Министерство законодательства).

• Лицензия — MIT.

Переменные окружения

Все переменные + примеры см. в .env.example.

Документация

Благодарности

Этот проект стал возможен благодаря следующим людям:

• chrisryugj — если бы вы не создали проекты korean-law-mcp и kordoc, этот проект не смог бы начаться. Искренне благодарю.

• jkg — спасибо за идею интеграции внутренних нормативных актов государственных учреждений ALIO.

Лицензия

MIT

Made by scvcoder