⚖️ LexGuard MCP (법실마리)

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

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

• MCP Endpoint: https://lexguard-mcp.onrender.com/mcp

• Health Check: https://lexguard-mcp.onrender.com/health

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

Быстрое подключение (копировать-вставить)

Если вы используете только удаленный MCP, вы можете вставить следующий JSON в настройки клиента.

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

• Claude Desktop: examples/claude-desktop-mcp.remote.json → объедините с mcpServers в claude_desktop_config.json

Локальный запуск одной командой (Docker): после docker compose up --build в корне репозитория URL MCP будет http://localhost:9099/mcp. (API-ключ: LAW_API_KEY=ваш_ключ docker compose up --build)

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

Why LexGuard?

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

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

• Пользователь задает вопрос на естественном языке.

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

• Предоставляет «нить» (решение) на основе официальных данных о законах и прецедентах.

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

Core Features

MCP Tools

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

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

Capabilities

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

• Обнаружение намерений (Intent) и приоритизация

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

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

Input Schema

Example Prompts

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

law_article_tool — Точный поиск статей закона

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

Input Schema

Example Prompts

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

law_comparison_tool — Сравнение законов (старая/новая редакция, история, 3-колоночное сравнение)

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

Input Schema

Example Prompts

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

document_issue_tool — Анализ контрактов и условий

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

Input Schema

Supported Document Types

• labor — Трудовой договор / Договор об оказании услуг

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

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

Example Prompts

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

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

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

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

Используются, когда нужно найти только определенные данные, вместо общего поиска (legal_qa_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

URL MCP для браузера/клиента: 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

Method 4. Remote MCP (хостинг URL)

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "lexguard-mcp": {
      "url": "https://lexguard-mcp.onrender.com/mcp"
    }
  }
}

Cursor (.cursor/mcp.json)

То же, что и файл examples/cursor-mcp.remote.json:

{
  "mcpServers": {
    "lexguard-mcp": {
      "url": "https://lexguard-mcp.onrender.com/mcp"
    }
  }
}

Выпуск API-ключа

Необходим ключ Open API Национального центра правовой информации.

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

2. Заявка на использование API

3. Установка LAW_API_KEY=ваш_ключ в .env

Architecture

Client (Cursor / Claude)
    │ JSON-RPC 2.0 over SSE
    ▼
FastAPI  (/mcp POST)
    │ Rate Limiting (slowapi, 60 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  (172개 엔드포인트)

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

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

Основные технологии

Development

# 테스트 실행
pytest tests/ -v

# 린트
ruff check src/

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

License

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

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

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

Данное руководство является кратким изложением, юридическую силу имеет оригинал LICENSE.

Contribution

Issues & PRs всегда приветствуются. Приветствуются данные по юридическим доменам, улучшение качества поиска, идеи для новых инструментов MCP.

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