KJH Law

대한민국 법령 검색/조회/분석을 위한 MCP 서버입니다. 법제처 Open API를 기반으로 89개 법률 도구를 제공합니다.

Based on korean-law-mcp by chrisryugj (MIT License)

---

사전 준비: API 키 발급

모든 사용법에 공통으로 필요한 **법제처 Open API 인증키(OC)**를 먼저 발급받으세요.

1. 법제처 Open API 신청 페이지에 접속
2. 회원가입 후 로그인
3. "Open API 사용 신청" 버튼 클릭
4. 신청서 작성 후 인증키(OC) 발급 (예: honggildong)

---

사용법

방법 1: Claude.ai 웹에서 바로 사용 (설치 없음)

Claude Pro/Max/Team/Enterprise 요금제에서 커넥터로 바로 사용할 수 있습니다.

1. claude.ai → 설정 → 커넥터 → 커스텀 커넥터 추가
2. 아래 URL 입력 (honggildong을 본인 인증키로 교체):

https://korean-law-mcp.fly.dev/mcp?profile=lite&oc=honggildong

3. 도구를 **"항상 사용"**으로 설정
4. 채팅에서 "근로기준법 제74조 알려줘"라고 입력하면 끝!

lite vs full: lite(14개 도구)로도 89개 전체 기능 사용 가능. URL에서 profile=lite&를 제거하면 full 모드.

방법 2: AI 데스크톱 앱 (Claude Desktop, Cursor, Windsurf 등)

설정 파일에 아래 내용을 추가하세요:

앱	설정 파일 위치
Claude Desktop (Win)	%APPDATA%\Claude\claude_desktop_config.json
Claude Desktop (Mac)	~/Library/Application Support/Claude/claude_desktop_config.json
Cursor / Windsurf	프로젝트 폴더 .cursor/mcp.json 또는 .windsurf/mcp.json

{
  "mcpServers": {
    "korean-law": {
      "url": "https://korean-law-mcp.fly.dev/mcp?oc=honggildong"
    }
  }
}

방법 3: 로컬 설치

npm install -g kjh-law-mcp

AI 앱 설정:

{
  "mcpServers": {
    "korean-law": {
      "command": "korean-law-mcp",
      "env": {
        "LAW_OC": "honggildong"
      }
    }
  }
}

방법 4: CLI 사용

# 인증키 설정
export LAW_OC=honggildong        # Mac/Linux
set LAW_OC=honggildong           # Windows CMD
$env:LAW_OC="honggildong"       # Windows PowerShell

# 사용 예시
korean-law "민법 제1조"                    # 자연어 조회
korean-law search_law --query "관세법"     # 도구 직접 호출
korean-law list                            # 전체 도구 목록
korean-law help search_law                 # 도구별 도움말

---

API 키 전달 방법

방법	사용법	용도
URL 포함	?oc=내키	웹 클라이언트
HTTP 헤더	apikey: 내키	프로그래밍 연동
환경변수	LAW_OC=내키	로컬 설치
도구 파라미터	apiKey: "내키"	특정 요청

---

사용 예시

"관세법 제38조 알려줘"
→ search_law("관세법") → MST 획득 → get_law_text(mst, jo="003800")

"화관법 최근 개정 비교"
→ "화관법" → "화학물질관리법" 자동 변환 → compare_old_new(mst)

"근로기준법 제74조 해석례"
→ search_interpretations("근로기준법 제74조") → get_interpretation_text(id)

"산업안전보건법 별표1 내용 알려줘"
→ get_annexes(lawName="산업안전보건법 별표1") → HWPX 다운로드 → Markdown 변환

---

도구 목록 (89개)

카테고리	개수	주요 도구
검색	11	search_law, search_precedents, search_all, get_annexes
조회	9	get_law_text, get_batch_articles, compare_old_new, get_three_tier
분석	10	compare_articles, get_law_tree, summarize_precedent, analyze_document
전문: 조세/관세	4	search_tax_tribunal_decisions, search_customs_interpretations
전문: 헌재/행심	4	search_constitutional_decisions, search_admin_appeals
전문: 위원회 결정	8	공정위, 개보위, 노동위, 감사원
특별행정심판	4	search_acr_special_appeals, search_appeal_review_decisions
법령-자치법규 연계	4	get_linked_ordinances, get_delegated_laws
조약	2	search_treaties, get_treaty_text
학칙/공단/공공기관	6	search_school_rules, search_public_corp_rules, search_public_institution_rules
지식베이스	7	get_legal_term_kb, get_daily_to_legal, get_related_laws
체인	8	chain_full_research, chain_law_system, chain_document_review
메타	2	discover_tools, execute_tool (lite 프로필용)
기타	10	AI 검색, 영문법령, 연혁법령, 법령용어, 약칭, 법체계도, 행정규칙비교

---

주요 특징

• 89개 법률 도구 - 법령, 판례, 행정규칙, 자치법규, 헌재결정, 조세심판, 관세해석, 조약 등
• MCP + CLI - AI 앱과 터미널 모두 지원
• 법률 도메인 특화 - 약칭 자동 인식(화관법 -> 화학물질관리법), 조문번호 변환
• 별표/별지서식 추출 - HWPX/HWP 파일 자동 다운로드 후 Markdown 변환
• 8개 체인 도구 - 복합 리서치를 한 번의 호출로 처리
• 도구 프로필 - lite(14개) / full(89개) 자동 선택
• 캐시 - 검색 1시간, 조문 24시간 TTL
• 원격 엔드포인트 - 설치 없이 바로 사용 가능

---

라이선스

MIT

Based on korean-law-mcp by chrisryugj (MIT License)