korean-law-mcp MCP工具

+ v4.0.9 — 법제처 API `Referer` 헤더 자동 주입

법제처 OPEN API가 Referer 헤더 없는 요청을 OC 키 유효 여부와 무관하게 거부("사용자 정보 검증 실패")하는 문제 대응. law.go.kr 계열 호스트 호출 시 기본 Referer를 자동 주입한다(LAW_REFERER로 override). IP/도메인 등록 문제로 오인되기 쉬운 증상의 실제 근본 원인이었음 — IP 등록을 했는데도 모든 검색이 실패하던 케이스를 해결. (외부 PR #45)

+ v4.0.6 — 법제처 API 프로토콜 설정 + 판례 재검색 개선

폐쇄망/인증서 문제 환경을 위해 LAW_API_PROTOCOL=http 옵션 추가(기본 https). 판례 재검색 키워드 후보 생성 개선으로 매칭률 향상. (외부 PR #41/#42)

0단계: API 키 발급 (무료, 1분)

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

1. 법제처 Open API 신청 페이지에 접속합니다.
2. 회원가입 후 로그인합니다.
3. "Open API 사용 신청" 버튼을 누릅니다.
4. 신청서를 작성하면 인증키(OC)가 발급됩니다. (예: honggildong)
5. 이 인증키를 아래 설정에서 사용합니다.

---

API 키 전달 방법 정리

여러 방법으로 인증키를 전달할 수 있습니다. 위에서부터 우선 적용됩니다:

법제처 API 프로토콜 설정

법제처 API 호출은 기본적으로 HTTPS를 사용합니다. 사내망·폐쇄망 등 인증서 검증이 어려운 환경에서는 LAW_API_PROTOCOL=http를 설정해 HTTP로 호출할 수 있습니다.

MCP 클라이언트 설정의 env 블록에 함께 넣는 방식이 가장 명확합니다:

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

터미널에서 직접 실행하거나 .env 파일을 사용할 수도 있습니다:

export LAW_API_PROTOCOL=http        # Mac/Linux
set LAW_API_PROTOCOL=http           # Windows CMD
$env:LAW_API_PROTOCOL="http"       # Windows PowerShell

LAW_OC=honggildong
LAW_API_PROTOCOL=http

허용값은 http, https입니다. 설정하지 않거나 다른 값을 넣으면 https가 사용됩니다.