MCP для корейского закона о защите персональных данных

Это MCP для поиска, сравнения, анализа и проверки Закона Республики Корея «О защите персональных данных» (PIPA) на естественном языке.

31 источник Министерства законодательства + 2 официальных индекса PIPC + 3 RAG-корпуса + 1 проверка на галлюцинации — всего 37 инструментов MCP, которые одновременно работают с PIPA, указами, уведомлениями PIPC, решениями, 4 видами официальных руководств PIPC и 1745 консультационными кейсами (всего 2202 чанка), помогая решать вопросы, связанные с законом о защите персональных данных.

Теперь вы можете обсуждать закон о защите персональных данных вместе с ИИ.

English

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

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

Однако малый бизнес, индивидуальные предприниматели и аптеки часто оказываются в «слепой зоне» из-за нехватки персонала и бюджета для преодоления невидимого барьера закона.

Я надеюсь, что этот MCP станет хоть немного полезным для тех, кому трудно получить доступ к закону о защите персональных данных.

v0.8 — Закон о защите персональных данных, смежное законодательство, руководства и консультационные кейсы в одном месте

Поверх 31 обертки OPEN API Министерства законодательства добавлены 2 официальных индекса PIPC + 3 RAG-корпуса руководств и кейсов + 1 четырехуровневая проверка на галлюцинации — всего 37 инструментов для поиска, сравнения и анализа корейского законодательства и официальных материалов PIPC на естественном языке.

Основные разработки

• Официальный RAG-корпус PIPC из 2202 чанков — практические материалы, которых нет в API Министерства законодательства. 4 вида руководств (457 чанков: 99 вопросов-ответов + 41 для малого бизнеса + 71 по CCTV + 246 отраслевых руководств) + 1745 консультационных кейсов с портала персональных данных. Применено Anthropic Contextual Retrieval. Построение индекса BM25 в памяти при загрузке (корейский токенизатор, prefix + fuzzy 0.2).

• Индексация официальных источников PIPC (кураторство 0) — структурированные таблицы по 8 отраслям из «Отраслевых руководств по защите персональных данных» (PIPC, 2024.12) + поиск по 12 законам и 23 административным правилам с портала персональных данных (privacy.go.kr/contsNo=116·117). Никаких наших мнений или маппинга — только официальные таблицы и списки портала PIPC. Ко всем ответам автоматически добавляются источник, страница, дата публикации и отказ от ответственности «требуется дополнительная проверка».

• Четырехуровневое отслеживание делегирования — объединение get_three_tier (Закон-Указ-Правила) + get_delegated_laws + поиск административных правил для отслеживания пути делегирования от статьи PIPA до уведомления PIPC одной строкой на естественном языке.

• Обработка временных интервалов — использование get_historical_law, get_article_change_history и get_law_history для проверки моментов поглощения Закона об информационно-коммуникационных сетях законом PIPA, текстов до и после поправок и цитирования старых статей.

• Поиск решений PIPC и каскадное сокращение — сокращение текстов решений (в среднем 10 000+ знаков) до 800 знаков в начале + пропуск + 400 знаков в конце. Обработка причуд ответов с учетом регистра (<Ppc> vs <ppc>).

• Четырехуровневая проверка на галлюцинации — verify_pipa_citation проверяет цитирование в порядке: название закона → статья → пункт → подпункт/абзац. При обнаружении галлюцинации выводится [HALLUCINATION_DETECTED] + пошаговая ✗ + подсказка по следующему инструменту. Проверка текста по времени с помощью as_of YYYYMMDD (например, была ли действительна статья 22 Закона об ИКТ в 2019 году).

• Стандартизация базовых ответов — 4 типа маркеров машинного парсинга: [NOT_FOUND] / [HALLUCINATION_DETECTED] / [OUT_OF_SCOPE] / [NOT_FOUND_SCOPE] + регулярный URL (📎 Источник: ...) + автоматическое добавление кандидатов на следующий инструмент (ИИ продолжает диалог естественно без цепочек).

• Автоматическое распознавание 17 сокращений законов — PIPA, 개보법 (Закон о защите ПД), 정통망법 (Закон об ИКТ), 신정법 (Закон о кредитной информации), 위치정보법 (Закон о геолокации), 통비법 (Закон о защите коммуникаций), 정보공개법 (Закон о раскрытии информации), 전자정부법 (Закон об электронном правительстве) и т.д. Словарь сокращений Министерства законодательства почти не содержит отраслевых сокращений, поэтому PRIVACY_ALIASES дополняет их.

Пример — от естественного языка до глубины домена одной строкой

"의료기관에서 환자 개인정보 처리할 때 어떤 법이 우선이야?"

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

• get_sectoral_related_laws("медицинское учреждение") — поиск по официальной таблице отраслевых руководств PIPC

• Раздельный вывод official_laws (официальная классификация PIPC) + additional_mentions (статистика частоты в тексте)

• Прямое цитирование PIPC по принципу lex specialis + автоматическое добавление источника, страницы, даты публикации и отказа от ответственности «требуется дополнительная проверка»

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

«Закон о защите персональных данных» является общим законом (general law), а Закон о медицинских услугах — специальным законом (lex specialis) в отношении персональных данных пациентов. PIPC также указал это в FAQ раздела для медицинских учреждений «Отраслевого руководства по защите персональных данных (2024.12)» — если есть положение в «Законе о медицинских услугах», применяется он, если нет — применяется «Закон о защите персональных данных».»

"개인정보 보호법 §28-2 가명정보 처리 조항이 2020년 6월 시점에 유효했어?"

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

• Вызов verify_pipa_citation(citation="Закон о защите персональных данных §28-2", as_of="20200601")

• Пошаговая проверка 4 уровней (Закон → Статья → Пункт → Подпункт/Абзац) через поиск текста по времени efYd

• При успехе ✅ + 4 уровня ✓ + mst·lawId + регулярный URL / при галлюцинации [HALLUCINATION_DETECTED] + пошаговая ✗

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

Заключение: Нет. На июнь 2020 года он еще не вступил в силу. Это часть поправок к так называемым «3 законам о данных» (Закон о защите ПД, Закон об ИКТ, Закон о кредитной информации), которые вступили в силу 5 августа после 6-месячного переходного периода после опубликования 4 февраля 2020 года. Поэтому в июне 2020 года при обработке псевдонимизированных данных нельзя было ссылаться на статью 28-2, и на тот момент самого положения общего закона, регулирующего понятие псевдонимизированных данных, не существовало (новые основания для законной обработки, такие как псевдонимизация и объединение для целей статистики, научных исследований и архивного хранения в общественных интересах, начались только после 5 августа).

Отслеживание домена PIPA + проверка цитирования одной строкой на естественном языке.

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

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

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

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

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

3. Нажмите кнопку «Подача заявки на использование OPEN API»

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

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

Метод 1: Использование прямо в веб-интерфейсе Claude.ai (без установки) — самый простой

Добавьте пользовательский коннектор в claude.ai. Требуется подписка Claude Pro/Max/Team/Enterprise (в бесплатной версии доступен только 1 коннектор).

Как добавить коннектор:

1. Войдите в claude.ai

2. Имя внизу боковой панели → «Настройки» → «Коннекторы»

3. Область «Пользовательские коннекторы» → «Добавить пользовательский коннектор»

4. Введите следующее (замените your-api-key-here на свой ключ):

   • Имя: korean-privacy-law (любое)

   • URL: https://scvcoder-korean-privacy-law-mcp.hf.space/mcp?oc=your-api-key-here

5. «Добавить» → регистрация завершена

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

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

"개인정보 보호법 제15조 알려줘"                                → 법령 조문 본문
"의료기관 환자 개인정보 처리할 때 어떤 법이 우선이야?"          → PIPC 분야별 매핑
"가족 동의 없이 자녀 사진 SNS 에 올리면?"                       → 상담사례 검색
"개인정보 보호법 §28-2 가 2020년 6월 시점에 유효했어?"           → 인용 조문 시점 검증
"PIPC 가 동의 없는 마케팅 문자 발송에 어떻게 의결했어?"          → PIPC 의결례

Удаленный сервер Hugging Face — это сервис «лучших усилий», предоставляемый оператором (scvcoder) бесплатно, без гарантии работы. Если хотите развернуть для собственного использования, см. docs/HUGGINGFACE.md (подписка Pro + 5 минут).

Метод 2: Использование в настольных ИИ-приложениях (Claude Desktop · Cursor · Windsurf)

Добавьте следующее содержимое в файл конфигурации (замените your-api-key-here на свой ключ):

{
  "mcpServers": {
    "korean-privacy-law": {
      "url": "https://scvcoder-korean-privacy-law-mcp.hf.space/mcp?oc=your-api-key-here"
    }
  }
}

Расположение файла конфигурации:

Если другие серверы MCP уже настроены, добавьте только часть "korean-privacy-law": { ... } внутри "mcpServers": { ... }. После сохранения перезапустите приложение.

Метод 3: Установка прямо на ваш компьютер (возможна офлайн-работа)

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

Подготовка: Node.js версии 18 или выше.

Автоматический запуск (npx, рекомендуется):

Добавьте следующее в файл конфигурации:

{
  "mcpServers": {
    "korean-privacy-law": {
      "command": "npx",
      "args": ["-y", "korean-privacy-law-mcp"],
      "env": {
        "LAW_OC": "your-api-key-here"
      }
    }
  }
}

Проверка кэша npm каждый раз — автоматическое применение новых версий.

Глобальная установка (быстрая загрузка):

npm install -g korean-privacy-law-mcp

Измените файл конфигурации на:

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

Загрузка на 0,5–1 секунду быстрее. Новые версии обновляются вручную через npm install -g korean-privacy-law-mcp.

Сборка из исходников (для разработчиков):

git clone https://github.com/scvcoder/korean-privacy-law-mcp.git
cd korean-privacy-law-mcp
npm install
npm run build

Укажите абсолютный путь в файле конфигурации:

{
  "mcpServers": {
    "korean-privacy-law": {
      "command": "node",
      "args": ["/절대경로/korean-privacy-law-mcp/dist/index.js"],
      "env": {
        "LAW_OC": "your-api-key-here"
      }
    }
  }
}

Или, если создать файл .env в корне проекта с LAW_OC=..., он загрузится автоматически — блок env можно опустить.

Подробности по шагам для Claude Desktop + устранение неполадок: docs/CLAUDE_DESKTOP.md

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

Сводка способов передачи API-ключа

Ключ можно передать несколькими способами. Применяется приоритет сверху вниз:

Примеры использования

Поиск законов, административных правил, решений и интерпретаций

Вы можете искать тексты законов, отношения делегирования до указов, правил и уведомлений PIPC, а также решения PIPC, решения Конституционного суда и интерпретации на естественном языке.

"개인정보 보호법 제15조 알려줘"
→ 해당 조문 본문과 법제처 정식 출처 링크를 함께 반환합니다.

"개인정보 영향평가 의무는 어떤 법령에 어디까지 정해져 있어?"
→ 법·시행령·시행규칙·PIPC 고시까지의 위임 경로를 한 번에 정리해 줍니다.

"PIPC 가 동의 없는 마케팅 문자 발송에 어떻게 의결했어?"
→ 관련 의결례를 찾아 핵심 부분을 발췌해 보여 줍니다."

Официальный отраслевой маппинг PIPC

Какой закон применяется в первую очередь в конкретной отрасли — вы получаете официальный ответ, опубликованный самим PIPC, вместе с источником. Это не наша обработка или интерпретация, а оригинальные таблицы PIPC.

"병원에서 환자 정보 처리할 때 의료법이랑 개인정보 보호법 중 뭐가 우선이야?"
→ PIPC 「분야별 개인정보 보호 안내서」 의 의료기관 편 답변을 그대로 보여 줍니다.

"개인정보 포털에 등록된 관련 법령·행정규칙 목록 알려줘"
→ privacy.go.kr 에 PIPC 가 직접 등록한 12 법령 + 23 행정규칙 list 를 반환합니다.

Поддерживаемые отрасли: кадры/трудовые отношения · учреждения социального обеспечения · медицинские учреждения · аптеки · академии/учебные центры · статистика · государственные учреждения · онлайн-розыгрыши. (Псевдонимы, такие как больница → медицинское учреждение, распознаются автоматически)

Поиск по руководствам и консультационным кейсам PIPC на естественном языке

Поиск по 4 видам официальных руководств, изданных PIPC, и 1745 консультационным кейсам с портала персональных данных на естественном языке. К каждому ответу прилагается официальный источник PIPC для проверки.

"가족 동의 없이 자녀 사진을 SNS 에 올려도 돼?"
→ 개인정보 포털의 관련 상담사례를 찾아 답변을 보여 줍니다.

"가명정보를 다른 회사 데이터와 결합하려면?"
→ 「개인정보 질의응답 모음집」 에서 해당 항목을 찾아 답변을 보여 줍니다.

"약국에서 처방전 보관할 때 주의할 점"
→ 가이드 4종 + 상담사례를 통합 검색해 가장 관련성 높은 항목을 보여 줍니다.

Проверка существования цитируемой статьи / действительности на тот момент

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

"개인정보 보호법 §15 ② 1호가 실제로 있는 조문인지 확인해 줘"
→ 법령·조·항·호·목 단계별로 존재 여부를 검증합니다.

"개인정보 보호법 §28-2 가 2020년 6월 시점에 유효했어?"
→ 그 시점 기준으로 조문이 시행 중이었는지 시점별 본문으로 검증합니다.

Названия законов распознаются даже при вводе сокращений (개보법, 정통망법, 신정법, 위치정보법, 통비법 и т.д.).

Структура инструментов (37)

Подробности всех инструментов (имя, параметры, примеры) см. в docs/API.md.

Основные характеристики

• Интеграция 37 инструментов — 31 от Министерства законодательства + 2 официальных индекса PIPC + 3 RAG-корпуса + 1 проверка на галлюцинации.

• Законы + смежные законы + руководства + консультационные кейсы — объединение с помощью RAG-корпуса руководств и кейсов, которые не охватывают обычные MCP законов, для обработки в одном MCP.

• Официальный RAG-корпус PIPC из 2202 чанков — 4 вида руководств (вопросы-ответы, справочник для малого бизнеса, руководство по CCTV, отраслевые руководства) + 1745 консультационных кейсов. Применено Contextual Retrieval.

• 100% индексация официальных источников PIPC — наше кураторство 0. Отраслевые руководства, законы и административные правила с портала персональных данных — как в таблицах PIPC.

• Маппинг отраслей на естественном языке — автоматическая нормализация псевдонимов (8 отраслей, например, «больница» → медицинское учреждение, «аудит» → государственное учреждение).

• Специализация на юридическом домене — автоматическое распознавание 17 сокращений (PIPA, 개보법, 정통망법, 신정법, 위치정보법 и т.д.), нормализация номеров статей (§28-2 ↔ 002802), отслеживание делегирования 4 уровней (Закон-Указ-Правила-Уведомление PIPC).

• Четырехуровневая проверка на галлюцинации — пошаговая проверка существования цитируемой статьи (Закон → Статья → Пункт → Подпункт/Абзац). Проверка по времени (as_of) для выявления цитирования старых статей.

• Удаленный + локальный режимы — мгновенное использование https://scvcoder-korean-privacy-law-mcp.hf.space ИЛИ локальный stdio через npx korean-privacy-law-mcp.

• Единый стандарт MCP — те же 37 инструментов везде: Claude.ai web, Claude Desktop, Cursor, Windsurf.

• Проверка — автоматическое тестирование 441 случая (npm test — реальные вызовы API Министерства законодательства + снимки, а не моки).

• Лицензия — MIT (код).

Источник исходных материалов RAG — руководства Комиссии по защите персональных данных и консультационные кейсы портала персональных данных (https://www.privacy.go.kr/front/case/list.do).

※ Если автор исходных материалов потребует удаления или изменения части или всех материалов, мы немедленно примем меры.

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

Автоматическая загрузка при размещении файла .env в корне проекта. Даже если spawn происходит из произвольного cwd, как в Claude Desktop, автоматически ищется ../.env относительно каталога скрипта. Если не найдено, выводится только предупреждение в stderr (сервер запускается — некоторые действия, такие как поиск RAG в Layer C, возможны и без ключа).

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

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

Лицензия и источник исходных материалов RAG

MIT (код)

Источник исходных материалов RAG — руководства Комиссии по защите персональных данных и консультационные кейсы портала персональных данных (https://www.privacy.go.kr/front/case/list.do).

※ Если автор исходных материалов потребует удаления или изменения части или всех материалов, мы немедленно примем меры.

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

Сделано scvcoder