⚖️ LexGuard MCP (법실마리)

MCP-сервер, который связывает корейские законы, судебные прецеденты и официальные толкования законодательства в форме, понятной ИИ

На основе официальных данных Национального центра правовой информации (Open Law) предоставляет законы, статьи, прецеденты, толкования законодательства, решения по административным обжалованиям и решения Конституционного суда в едином потоке одного вопроса.

• Способ запуска: self-host MCP-сервер, запускаемый с вашим собственным API-ключом Национального центра правовой информации (без отдельного хостинга)

• GitHub: https://github.com/SeoNaRu/lexguard-mcp

Быстрый старт (5 минут)

1. Получение API-ключа — бесплатное получение на open.law.go.kr. При подаче заявки обязательна регистрация вашего IP (см. раздел Получение API-ключа ниже)

2. Запуск сервера

   git clone https://github.com/SeoNaRu/lexguard-mcp
   cd lexguard-mcp
   cp .env.example .env        # LAW_API_KEY=발급키 설정
   docker compose up --build   # 또는: pip install -r requirements.txt && python -m src.main

3. Подключение клиента — MCP URL: http://localhost:9099/mcp

   • Cursor: объедините содержимое examples/cursor-mcp.local.json в .cursor/mcp.json

   • Claude Desktop: объедините examples/claude-desktop-mcp.local.json → в mcpServers файла claude_desktop_config.json (требуется Node.js)

Статический мета-файл для маркетплейсов и краулеров: mcp/manifest.json · индекс промптов prompts/ · руководство по URI ресурсов resources/README.md · навык разработки для Cursor .cursor/skills/lexguard-mcp-dev/SKILL.md

Why LexGuard?

Закон часто кажется далёким и сложным именно тогда, когда он нужен. Высокая стоимость, незнакомые термины, структура, в которой непонятно, с чего начать поиск.

LexGuard MCP(법실마리) появился именно из-за этой проблемы.

• Пользователь задаёт вопрос человеческими словами

• ИИ анализирует намерение вопроса

• и предоставляет зацепку на основе официальных данных законов и судебных прецедентов.

Мы не заменяем суждение или юридическую консультацию. Наша цель — сделать момент первой встречи с законом менее сложным.

Related MCP server: LexLink

Core Features

MCP Tools

legal_qa_tool — универсальный юридический QA

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

Возможности

• Автоматическая классификация по 10 доменам

• Множественное определение намерения вопроса (Intent) и сортировка по приоритету

• Параллельный поиск: закон → прецедент → толкование → комитет

• Фильтрация по временным условиям на естественном языке (автоматическое преобразование date_from / date_to)

Схема входных данных

Примеры запросов

프리랜서인데 근로자성 인정된 판례 있나요?
최근 3년 부당해고 판례 알려줘
개인정보 유출됐는데 법적으로 어떻게 되나요?
2023다12345 판례 찾아줘

law_article_tool — точный запрос статьи закона

Прямой запрос конкретной статьи, когда известны название закона и номер статьи. Если legal_qa_tool — это «поиск», то этот инструмент — «точный запрос».

Схема входных данных

Примеры запросов

근로기준법 제50조 내용 알려줘
민법 제750조 3항이 뭐야?
개인정보보호법 제17조

law_comparison_tool — сравнение законов: старая и новая редакции, история изменений, трёхступенчатое сравнение

Выполняет сравнение старой и новой редакций закона, историю изменений и трёхступенчатое сравнение по названию закона. Для просмотра оригинала текста статьи используйте law_article_tool, для общих вопросов — legal_qa_tool.

Схема входных данных

Примеры запросов

근로기준법 신구법 비교 보여줘
민법 연혁 조회

document_issue_tool — анализ договоров и условий

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

Схема входных данных

Поддерживаемые типы документов

• labor — трудовой договор / договор на оказание услуг

• lease — договор аренды

• terms — условия использования

Примеры запросов

이 프리랜서 계약서 문제 있는지 봐줘
아래 임대차 계약서에서 불리한 조항 찾아줘

health — проверка состояния сервера

Проверяет работоспособность MCP-сервера, статус настройки API-ключа и переменные окружения.

Специализированные инструменты поиска (по ограниченным источникам)

Используются, когда нужно найти только определённые данные вместо интегрированного поиска (legal_qa_tool).

Инструменты расширенного поиска

Используются, когда нужен углублённый поиск: дополнительная информация о законе, история изменений, формы, связи и т. д.

ministry_interpretation_tool — толкование законодательства по ведомствам

Выполняет поиск по базе данных официальных толкований (ответы на запросы) 39 ведомств. Если interpretation_tool — это интегрированный поиск, то этот инструмент напрямую запрашивает только толкования конкретного ведомства.

Поддерживаемые ведомства: Министерство занятости и труда, Министерство земли, инфраструктуры и транспорта, Министерство экономики и финансов, Национальная налоговая служба, Таможенная служба, Министерство образования, Министерство здравоохранения и социального обеспечения, Министерство юстиции, Министерство законодательства, Министерство по безопасности пищевых продуктов и лекарственных средств, Национальное полицейское агентство, Национальное пожарное агентство, Береговая охрана и ещё 39 учреждений.

law_history_tool — история изменений закона и его статей

Отслеживает, когда и как вносились изменения в закон.

Примеры запросов

근로기준법 개정 이력 알려줘
개인정보보호법 제17조 조문 개정 내역

law_info_tool — дополнительная информация о законе

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

law_form_tool — поиск форм из приложений (별표서식)

Ищет формы из приложений законов, административных правил и местных нормативных актов по названию формы или названию связанного закона.

law_link_tool — запрос связей между законами и местными нормативными актами

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

MCP Prompts

Поддерживаются эндпоинты prompts/list и prompts/get.

MCP Resources

Поддерживаются эндпоинты resources/list и resources/read.

URI Scheme

Featured Resources (предоставляются по умолчанию)

Можно мгновенно запросить основные законы: Трудовой кодекс, Гражданский кодекс, Уголовный кодекс, Закон о защите персональных данных, Торговый кодекс, Закон о государственных служащих, Закон об административном судопроизводстве и другие.

Installation

Method 1. Local (Python)

git clone https://github.com/SeoNaRu/lexguard-mcp
cd lexguard-mcp
pip install -r requirements.txt
cp .env.example .env   # LAW_API_KEY 설정
python -m src.main

Method 2. Docker Compose (рекомендуется · почти одной командой)

git clone https://github.com/SeoNaRu/lexguard-mcp
cd lexguard-mcp
cp .env.example .env   # LAW_API_KEY 편집
docker compose up --build

MCP URL для браузера/клиента: http://localhost:9099/mcp · health: http://localhost:9099/health

Method 3. Docker (только run)

docker build -t lexguard-mcp .
docker run -p 9099:9099 -e LAW_API_KEY=your_key lexguard-mcp

Подключение клиента

Когда сервер запущен локально, MCP URL — http://localhost:9099/mcp.

Cursor (.cursor/mcp.json) — то же, что и в файле examples/cursor-mcp.local.json:

{
  "mcpServers": {
    "lexguard-mcp": {
      "url": "http://localhost:9099/mcp"
    }
  }
}

Claude Desktop (claude_desktop_config.json) — то же, что и в файле examples/claude-desktop-mcp.local.json. Так как Claude Desktop не поддерживает локальные HTTP URL напрямую, используется мост mcp-remote (требуется Node.js):

{
  "mcpServers": {
    "lexguard-mcp": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "http://localhost:9099/mcp"]
    }
  }
}

Примечание о веб-коннекторе claude.ai: веб-коннектору требуется публичный HTTPS URL, поэтому он не может подключиться к локально запущенному серверу. Рекомендуется использовать Claude Desktop или Cursor. Если вам обязательно нужно использовать его в вебе, разверните сервер на собственном сервере (статический IP + HTTPS) и зарегистрируйте этот IP на open.law.go.kr.

Получение API-ключа (обязательно)

Требуется Open API-ключ Национального центра правовой информации. И получение, и использование бесплатны.

1. Регистрация на https://open.law.go.kr

2. Заявка на использование OPEN API — при этом необходимо зарегистрировать IP или домен сервера (вашего ПК), с которого будут отправляться запросы. law.go.kr принимает только запросы с зарегистрированных IP.

3. Укажите в .env параметр LAW_API_KEY=발급받은키 (полученный вами ключ)

Внимание: динамический IP: на обычных домашних линиях IP может меняться. Если появляется ошибка "사용자 정보 검증에 실패하였습니다" («Не удалось проверить информацию о пользователе»), перерегистрируйте текущий IP в разделе [open.law.go.kr → API인증키관리] (управление ключами аутентификации API).

Выбор схемы DRF

lexguard-mcp позволяет выбирать только схему (scheme) через .env, при этом host/path DRF URL Национального центра правовой информации остаются фиксированными.

LAW_GO_KR_DRF_SCHEME=https

• Допустимые значения: http, https

• Значение по умолчанию: https

• В ограниченных корпоративных сетях / средах с межсетевым экраном может потребоваться путь http://www.law.go.kr/DRF/... в соответствии с примерами из официального руководства.

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

Architecture

Client (Cursor / Claude)
    │ JSON-RPC 2.0 over SSE
    ▼
FastAPI  (/mcp POST)
    │ Rate Limiting (slowapi, 600 req/min/IP 기본값)
    ▼
MCP Routes  (tools/call · prompts/get · resources/read)
    │
    ▼
Services  (SmartSearchService · SituationGuidanceService)
    │ asyncio.gather (병렬 멀티 API 호출)
    ▼
Repositories  (Law · Precedent · Interpretation · Appeal · Constitutional …)
    │ httpx (동기/비동기 HTTP 클라이언트)
    │ TTLCache (검색 결과 30분 / 실패 5분)
    │ Exponential Backoff Retry
    ▼
국가법령정보센터 DRF API  (159개 엔트리 / 88개 unique target)

Конвейер поиска

질문 입력
    → 판례 번호 패턴 조기 감지 (2023다12345 / 2021헌마123)
    → 도메인 분류 + 의도(Intent) 분석
    → 시간 조건 파싱
    → asyncio.gather 병렬 API 호출
    → Reranker (BM25 + Keyword Hybrid 재정렬)
    → 응답 포매팅

Основной технологический стек

Разработка

# 테스트 실행
pytest tests/ -v

# 린트
ruff check src/

# 로컬 서버 (자동 재로드)
RELOAD=true python -m src.main

Лицензия

Полный текст приведён в файле LICENSE в корне репозитория.

• Использование: как и MIT, разрешает исследовательское, личное и коммерческое использование, включая модификацию, распространение и перепродажу.

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

Настоящее описание является краткой сводкой; юридическую силу имеет оригинальный текст LICENSE.

Вклад

Issues и PR всегда приветствуются. Приветствуются данные из юридической области, улучшения качества поиска и новые идеи для MCP-инструментов.

LexGuard MCP — помогаем найти зацепку к юридической информации. Закон сложен, но первая зацепка может оказаться простой.