⚖️ LexGuard MCP (법실마리)

韓国の法令・判例・法令解釈をAIが理解しやすい形で接続するMCPサーバー

国家法令情報センター(Open Law)公式データに基づき、法令・条文・判例・法令解釈・行政審判・憲裁決定を一つの質問フローで提供します。

• 実行方式: ご自身の国家法令情報センターAPIキーで直接実行するself-host MCPサーバー(別途ホスティングサービスなし)

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

クイックスタート(5分)

1. APIキー発行 — open.law.go.krで無料発行。申請時にご自身のIP登録必須(下記API Key発行参照)

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 → claude_desktop_config.jsonのmcpServersにマージ(Node.js必要)

マーケットプレイス・クローラー用静的メタ: mcp/manifest.json · プロンプト索引 prompts/ · リソースURI案内 resources/README.md · Cursor開発スキル .cursor/skills/lexguard-mcp-dev/SKILL.md

Why LexGuard?

法律は、必要なときに限って遠くて難しく感じられます。 高いコスト、馴染みのない用語、どこから探せばいいのか分からない構造。

LexGuard MCP(법실마리) は、この問題から出発しました。

• ユーザーは人間の言葉で質問し

• AIは質問の意図を分析した後

• 公式の法令・判例データに基づいて手がかりを提供します。

判断や法律相談の代わりにはなりません。 ただし、法律に初めて向き合う瞬間を少しでも易しくすることを目指しています。

Related MCP server: LexLink

Core Features

MCP Tools

legal_qa_tool — 汎用法律QA

すべての法律質問の単一エントリーポイントです。1つの質問で法令・判例・解釈・委員会決定例を並列探索して総合します。出典を限定した検索(判例のみ、解釈のみなど)は、各専用ツールを検討できます。

Capabilities

• 10ドメイン自動分類

• 質問意図(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 Key設定状態、環境変数を確認します。

専用検索ツール(出典限定)

統合検索(legal_qa_tool)の代わりに特定データのみを探す場合に使用します。

拡張照会ツール

法令付加情報、履歴、様式、連携などの深層照会が必要な場合に使用します。

ministry_interpretation_tool — 省庁別法令解釈

39省庁専用の法令解釈(質疑回信)データベースを検索します。interpretation_toolが統合検索なら、このツールは特定省庁の解釈のみを直接照会します。

対応省庁: 雇用労働部、国土交通部、企画財政部、国税庁、関税庁、教育部、保健福祉部、法務部、法制処、食品医薬品安全処、警察庁、消防庁、海洋警察庁ほか39機関

law_history_tool — 法令・条文変更履歴

法令がいつどのように改正されたかを追跡します。

Example Prompts

근로기준법 개정 이력 알려줘
개인정보보호법 제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 (推奨・1行に近い)

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 · ヘルス: 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 Key発行 (必須)

国家法令情報センターOpen APIキーが必要です。発行と使用はどちらも無料です。

1. https://open.law.go.kr 会員登録

2. OPEN API活用申請 — このときリクエストを送信するサーバー(ご自身のPC)のIPまたはドメインを登録する必要があります。law.go.krは登録されたIPからのリクエストのみ許可します。

3. .envにLAW_API_KEY=発行されたキーを設定

動的IP注意: 一般的な家庭回線はIPが変わる可能性があります。"사용자 정보 검증에 실패하였습니다"エラーが出た場合は、[open.law.go.kr → API인증키관리]で現在のIPに再登録してください。

DRF scheme選択

lexguard-mcpは国家法令情報センターDRF URLのhost/pathを固定したまま、schemeのみを.envで選択できます。

LAW_GO_KR_DRF_SCHEME=https

• 許容値: http, https

• デフォルト値: https

• 制限された企業ネットワーク/ファイアウォール環境では、公式ガイド例に合わせたhttp://www.law.go.kr/DRF/...パスが必要な場合があります。

この設定は、httpsハードコーディングが一般的な環境で偶然隠れてしまう可能性があった潜在的なURL生成問題を、運用環境ごとに調整するためのオプションです。

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 & PRs はいつでも歓迎します。 法律ドメインデータ、検索品質の改善、新しいMCPツールのアイデア、すべて歓迎します。

LexGuard MCP — 法律情報の手がかりを見つけます。 法律は難しいですが、最初の手がかりは簡単になるかもしれません。