# KJH Law MCP - 법률 검색 MCP 서버

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

> Based on [korean-law-mcp](https://github.com/chrisryugj/korean-law-mcp) by chrisryugj (MIT License)

---

## 사전 준비: API 키 발급

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

1. [법제처 Open API 신청 페이지](https://open.law.go.kr/LSO/openApi/guideList.do)에 접속
2. 회원가입 후 로그인
3. **"Open API 사용 신청"** 버튼 클릭
4. 신청서 작성 후 **인증키(OC)** 발급 (예: `honggildong`)

---

## 사용법

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

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

1. [claude.ai](https://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` |

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

### 방법 3: 로컬 설치

```bash
npm install -g kjh-law-mcp
```

AI 앱 설정:

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

### 방법 4: CLI 사용

```bash
# 인증키 설정
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](./LICENSE)

> Based on [korean-law-mcp](https://github.com/chrisryugj/korean-law-mcp) by chrisryugj (MIT License)