Korean law: statutes, precedents, ordinances, treaties and citation verification (법제처 API).
io.github.chrisryugj/korean-law-mcp — Model Context Protocol (MCP) Server
This MCP server provides access to Korean law resources, including statutes, precedents, ordinances, and treaties. It also supports citation verification using the 법제처 API, enabling developers to validate citations against official sources.
🛠️ Key Features
Korean law content: statutes, precedents, ordinances, treaties
Citation verification via 법제처 API
🚀 Use Cases
Confirming the correctness of Korean legal citations
Retrieving reference materials for Korean legal topics
⚡ Developer Benefits
Programmatic access to Korean legal sources
Built-in citation verification using a specific official API (법제처)
⚠️ Limitations
Description does not specify additional tools beyond citation verification and law coverage
Korean-law-mcp — [법령검색] 법령명·조례명·행정규칙명 키워드검색 → lawId, mst 획득. 지자체 조례·규칙(자치법규), 훈령·예규·고시(행정규칙)도 검색 — 0건 시 자치법규/행정규칙으로 자동 폴백(예: '광진구 복무조례', '외국환거래규정'). 약칭 자동변환. 제명변경·시행예정 개정 자동 병기. 폐지된 법령·행정규칙은 폐지 사실과 후속(통합) 규정을 자동 안내. 법령·조례·행정규칙 조회 전 식별자 확보용.
Korean-law-mcp — [법령조회] 조문 전문 조회. mst/lawId 필수, jo로 특정 조문만 가능 — jo는 '제148조의2' 같은 자연어 조문 표기를 그대로 받는다(권장). 6자리 JO 코드를 직접 쓰려면 조번호 4자리 zero-pad + 의X 2자리: 제10조의2→001002, 제234조의2→023402(234002 아님). jo='부칙' 이면 부칙 원문(시행일·경과조치, 최근 공포부터). 과거 시점 본문은 efYd 에 그 날짜를 넣으면 그날 시행 중이던 버전으로 자동 보정한다(제명이 바뀌기 전 버전 포함).
Parameters4
mst
string
optional
법령일련번호 (MST)
lawId
string
optional
법령ID
jo
string
optional
조문 번호. 자연어 표기 권장 — '제38조'·'제148조의2'를 그대로 넣으면 서버가 변환한다. 6자리 JO 코드 직접 지정 시 조번호 4자리 zero-pad + 의X 2자리: 제38조→003800, 제10조의2→001002, 제234조의2→023402(234002 아님). '부칙' 이면 부칙 원문(최근 공포부터)
efYd
string
optional
기준일 또는 시행일자 (YYYYMMDD). 시행일이면 그 버전, 시행일이 아닌 날짜(건축허가일·사건일 같은 조회 기준일)면 그날 시행 중이던 버전으로 자동 보정한다(제명이 바뀌기 전 버전 포함). 현행 본문은 efYd 없이 조회한다. 시행예정본은 그 시행일을 넣는다.
Raw schema
{
"type": "object",
"properties": {
"mst": {
"description": "법령일련번호 (MST)",
"type": "string"
},
"lawId": {
"description": "법령ID",
"type": "string"
},
"jo": {
"description": "조문 번호. 자연어 표기 권장 — '제38조'·'제148조의2'를 그대로 넣으면 서버가 변환한다. 6자리 JO 코드 직접 지정 시 조번호 4자리 zero-pad + 의X 2자리: 제38조→003800, 제10조의2→001002, 제234조의2→023402(234002 아님). '부칙' 이면 부칙 원문(최근 공포부터)",
"type": "string"
},
"efYd": {
"description": "기준일 또는 시행일자 (YYYYMMDD). 시행일이면 그 버전, 시행일이 아닌 날짜(건축허가일·사건일 같은 조회 기준일)면 그날 시행 중이던 버전으로 자동 보정한다(제명이 바뀌기 전 버전 포함). 현행 본문은 efYd 없이 조회한다. 시행예정본은 그 시행일을 넣는다.",
"type": "string"
}
},
"required": [],
"additionalProperties": false
}
ordinance_radar
Korean-law-mcp — [자치법규] 조례 정비 레이더 — 조례가 인용한 근거 상위법령(법률/시행령/시행규칙)을 본문에서 추출하고, 각 상위법의 현행 시행일과 조례 시행일을 대조해 '상위법이 조례 시행 이후 개정됨 → 정비 검토 대상'을 자동 플래그. 조례 담당 공무원의 상위법 개정 추적·조례 정비 판단용. ordinSeq(또는 id)나 ordinanceName 중 하나 지정.
Parameters4
ordinSeq
string
optional
자치법규 일련번호 (ordinSeq)
id
string
optional
ordinSeq 별칭 — 힌트가 id=로 안내하는 경우 대응
ordinanceName
string
optional
자치법규명 — 지정 시 검색 후 첫 결과 사용 (예: '서울특별시 광진구 주차장 설치 및 관리 조례')
query
string
optional
ordinanceName 별칭 — 자연어 조례명으로 검색
Raw schema
{
"type": "object",
"properties": {
"ordinSeq": {
"description": "자치법규 일련번호 (ordinSeq)",
"type": "string"
},
"id": {
"description": "ordinSeq 별칭 — 힌트가 id=로 안내하는 경우 대응",
"type": "string"
},
"ordinanceName": {
"description": "자치법규명 — 지정 시 검색 후 첫 결과 사용 (예: '서울특별시 광진구 주차장 설치 및 관리 조례')",
"type": "string"
},
"query": {
"description": "ordinanceName 별칭 — 자연어 조례명으로 검색",
"type": "string"
}
},
"required": [],
"additionalProperties": false
}
get_annexes
Korean-law-mcp — [별표] 별표/서식 조회. lawName+'별표N'으로 내용 추출. 금액/기준은 별표에 있는 경우 많음. date(기준일)를 주면 그날 시행 중이던 버전의 별표 — 건축허가·착공·처분 시점의 설치기준·과태료표 등 과거 기준이 필요할 때(제명이 바뀐 법령도 옛 버전까지, 별표 번호가 시점마다 달라 query로 별표명을 주는 편이 안전).
Parameters7
lawName
string
required
법령명 (예: '관세법'). 별표를 바로 지정하려면 '... 별표4' 또는 '... 별표1의2'처럼 함께 입력 가능
knd
string
optional
1=별표, 2=서식, 3=부칙별표, 4=부칙서식, 5=전체
bylSeq
string
optional
별표번호 (예: '000300'). 지정 시 해당 별표 파일을 다운로드하여 텍스트로 추출
annexNo
string
optional
별표 번호 (예: '4', '별표4', '제4호'). bylSeq 대체 입력
query
string
optional
별표명으로 좁히기 (예: '운전면허 취소·정지', '과태료'). 번호를 모를 때 사용. 1건으로 좁혀지면 그 별표 본문을 바로 추출
기준일 (예: '2015-06-01'). 지정 시 그날 시행 중이던 법령 버전의 별표를 조회 — 건축허가·착공·처분·위반 시점 기준이 필요할 때. 제명이 바뀐 법령도 옛 버전까지 찾는다. 별표 번호는 시점마다 다를 수 있으니 query(별표명)로 좁히는 것이 안전. 미지정 시 현행
Raw schema
{
"type": "object",
"properties": {
"lawName": {
"type": "string",
"description": "법령명 (예: '관세법'). 별표를 바로 지정하려면 '... 별표4' 또는 '... 별표1의2'처럼 함께 입력 가능"
},
"knd": {
"description": "1=별표, 2=서식, 3=부칙별표, 4=부칙서식, 5=전체",
"type": "string",
"enum": [
"1",
"2",
"3",
"4",
"5"
]
},
"bylSeq": {
"description": "별표번호 (예: '000300'). 지정 시 해당 별표 파일을 다운로드하여 텍스트로 추출",
"type": "string"
},
"annexNo": {
"description": "별표 번호 (예: '4', '별표4', '제4호'). bylSeq 대체 입력",
"type": "string"
},
"query": {
"description": "별표명으로 좁히기 (예: '운전면허 취소·정지', '과태료'). 번호를 모를 때 사용. 1건으로 좁혀지면 그 별표 본문을 바로 추출",
"type": "string"
},
"jo": {
"description": "위임 조문 (예: '제38조', '38'). 조문 동반 질의('관세법 제38조 별표2')의 조문 맥락 — 별표명의 '(제38조 관련)' 표기와 대조해 좁히고, 응답에 위임 관계를 표기",
"type": "string"
},
"date": {
"description": "기준일 (예: '2015-06-01'). 지정 시 그날 시행 중이던 법령 버전의 별표를 조회 — 건축허가·착공·처분·위반 시점 기준이 필요할 때. 제명이 바뀐 법령도 옛 버전까지 찾는다. 별표 번호는 시점마다 다를 수 있으니 query(별표명)로 좁히는 것이 안전. 미지정 시 현행",
"type": "string"
}
},
"required": [
"lawName"
],
"additionalProperties": false
}
legal_research
Korean-law-mcp — [⛓리서치] 다단계 법령 리서치 통합 — 여러 API를 병렬로 엮는 복합 질문 전용. task: full_research=도메인·법령명 불명확한 자연어 질문 폴백(기본값, 예 '음주운전 처벌 기준') | law_system=법률·시행령·시행규칙 3단+위임+별표(예 '관세법 체계') | action_basis=처분·허가의 법적 근거+해석례+판례+행심(예 '영업정지 근거') | dispute_prep=불복·소송 준비, 판례+심판례+도메인 결정례(예 '과세처분 불복') | amendment_track=개정 이력+신구대조+연혁(예 '2023년 개정 뭐 바뀜') | ordinance_compare=조례 전국 비교+상위법 적합성(예 '서울시 주차 조례') | procedure_detail=절차·수수료·별표서식(예 '건축허가 절차') | document_review=계약서·약관 조항 리스크+근거법령(text 필수). scenario(선택): 확장 시나리오 — time_travel(두 시점 본문 diff)·timeline·penalty·action_plan·delegation·impact·compliance·customs·manual. 미지정 시 쿼리에서 자동 감지되며, task별 호환 조합은 scenario 파라미터 설명 참조.
Parameters13
query
string
optional
자연어 질문/법령명/키워드 (예: '음주운전 처벌 기준', '관세법 체계'). document_review 외 모든 task에서 필수
task
string
optional
리서치 유형 (도구 설명의 task 표 참조). 미지정 시 full_research
scenario
string
optional
확장 시나리오. 미지정 시 쿼리에서 자동 감지. task별 호환: law_system=delegation·impact | action_basis=penalty | amendment_track=timeline·time_travel | ordinance_compare=compliance | full_research=customs·action_plan | procedure_detail=manual
domain
string
optional
[dispute_prep] 전문 분야 (tax=조세심판, labor=노동위, privacy=개인정보위, competition=공정위). 미지정 시 자동 감지
articles
array
optional
[law_system] 함께 조회할 조문 번호 (예: ['제38조'])
parentLaw
string
optional
[ordinance_compare] 상위 법령명. 미지정 시 자동 검색
mst
string
optional
[amendment_track] 법령일련번호 (알고 있으면)
lawId
string
optional
[amendment_track] 법령ID (알고 있으면)
fromDate
string
optional
[time_travel] 비교 시작 시점 YYYYMMDD
toDate
string
optional
[time_travel] 비교 종료 시점 YYYYMMDD
includeHistory
boolean
optional
[amendment_track] 조문별 개정 이력(제정 시점부터 전건)까지 포함. 기본 false — 이 섹션이 응답 상한을 먼저 소진해 신구대조표가 잘린다 (#158)
text
string
optional
[document_review 전용·필수] 검토할 계약서/약관 전문 텍스트
maxClauses
number
optional
[document_review] 최대 분석 조항 수 (기본 15)
Raw schema
{
"type": "object",
"properties": {
"query": {
"description": "자연어 질문/법령명/키워드 (예: '음주운전 처벌 기준', '관세법 체계'). document_review 외 모든 task에서 필수",
"type": "string",
"maxLength": 2000
},
"task": {
"default": "full_research",
"description": "리서치 유형 (도구 설명의 task 표 참조). 미지정 시 full_research",
"type": "string",
"enum": [
"full_research",
"law_system",
"action_basis",
"dispute_prep",
"amendment_track",
"ordinance_compare",
"procedure_detail",
"document_review"
]
},
"scenario": {
"description": "확장 시나리오. 미지정 시 쿼리에서 자동 감지. task별 호환: law_system=delegation·impact | action_basis=penalty | amendment_track=timeline·time_travel | ordinance_compare=compliance | full_research=customs·action_plan | procedure_detail=manual",
"type": "string",
"enum": [
"delegation",
"impact",
"penalty",
"timeline",
"time_travel",
"compliance",
"customs",
"action_plan",
"manual"
]
},
"domain": {
"description": "[dispute_prep] 전문 분야 (tax=조세심판, labor=노동위, privacy=개인정보위, competition=공정위). 미지정 시 자동 감지",
"type": "string",
"enum": [
"tax",
"labor",
"privacy",
"competition",
"general"
]
},
"articles": {
"description": "[law_system] 함께 조회할 조문 번호 (예: ['제38조'])",
"type": "array",
"items": {
"type": "string"
}
},
"parentLaw": {
"description": "[ordinance_compare] 상위 법령명. 미지정 시 자동 검색",
"type": "string"
},
"mst": {
"description": "[amendment_track] 법령일련번호 (알고 있으면)",
"type": "string"
},
"lawId": {
"description": "[amendment_track] 법령ID (알고 있으면)",
"type": "string"
},
"fromDate": {
"description": "[time_travel] 비교 시작 시점 YYYYMMDD",
"type": "string",
"pattern": "^\\d{8}$"
},
"toDate": {
"description": "[time_travel] 비교 종료 시점 YYYYMMDD",
"type": "string",
"pattern": "^\\d{8}$"
},
"includeHistory": {
"description": "[amendment_track] 조문별 개정 이력(제정 시점부터 전건)까지 포함. 기본 false — 이 섹션이 응답 상한을 먼저 소진해 신구대조표가 잘린다 (#158)",
"type": "boolean"
},
"text": {
"description": "[document_review 전용·필수] 검토할 계약서/약관 전문 텍스트",
"type": "string"
},
"maxClauses": {
"description": "[document_review] 최대 분석 조항 수 (기본 15)",
"type": "number",
"minimum": 1,
"maximum": 30
}
},
"required": [],
"additionalProperties": false
}
legal_analysis
Korean-law-mcp — [정밀분석] 검증·분석·신구조문대비표 5종 통합. mode: verify_citations=텍스트 속 법령 조문·판례 인용('민법 제750조', '대법원 2013다61381' 등)이 실존하는지 법제처 DB 교차검증, LLM 환각 방지 — 판례는 실존불가/미확인 구분(text 필수) | cite_check=판례 생사 확인 — 사건번호로 후속 인용 역추적+변경·폐기 감지, 한국형 Citator(caseNumber 필수) | applicable_law=사건 시점에 시행되던 법령 버전+그 시점 조문+부칙 경과조치, 행위시법 판단(lawName+date 필수, jo 선택). 제명이 바뀐 법령은 옛 이름 시절 버전으로 특정. 법령이 아니면 행정규칙(고시·훈령 — 예: '스프링클러설비의 화재안전기준', 'NFTC 103')의 기준일 시행 버전 | impact_map=한 조문을 인용한 판례·헌재·해석례·행심·조례 역방향 그래프+mermaid(lawName+jo 필수, jo는 '제103조'·'103조'·JO 6자리 코드 '010300' 모두 수용) | amendment_table=일부개정안의 신구조문대비표(신·구조문대비표·신구대비표·개정안 대비표) 작성 — 개정 후 조문만 주면 현행 조문을 법제처에서 가져와 법제처 대비표 표기 그대로 대조: 바뀐 부분 밑줄(채팅 표에서는 굵은 글씨), 개정안 칸의 같은 부분 '----'(글자 수만큼, 문장 끝 마침표 유지), 같은 항·호 '①·② (생 략)'/'(현행과 같음)' 묶음, <신 설>·<삭 제>·<단서 신설>. 줄표 수·묶음·밑줄 범위를 규칙대로 계산한 결과라 표를 그대로 쓸 수 있다(lawName+amendments 필수, 조례·행정규칙은 amendments[].currentText). 로컬 실행에서는 outputPath 로 한글(.hwpx) 저장
Parameters14
mode
string
required
분석 유형 (도구 설명의 mode 표 참조)
text
string
optional
[verify_citations 필수] 검증할 법률 텍스트 (LLM 답변/계약서 등 조문 인용 포함 문자열)
caseNumber
string
optional
[cite_check 필수] 사건번호 (예: '2013다61381', 문장 포함 가능)
lawName
string
optional
[applicable_law·impact_map·amendment_table 필수] 법령명 (예: '민법', '도로교통법'). applicable_law는 약칭·옛 법령명과 행정규칙명(고시 — 예: '스프링클러설비의 화재안전기준', 'NFTC 103')도 받는다. amendment_table은 조례·행정규칙이면 amendments[].currentText 로 현행 원문을 같이 준다
jo
string
optional
[impact_map 필수, applicable_law 선택] 조문 번호 — 자연어 표기('제103조', '제10조의2')와 6자리 JO 코드('010300', '001002') 모두 수용
true=본문 전문 그대로. 미지정=이유/전문 섹션 계단식 축약 (판시·요지·주문은 항상 full)
options
object
optional
도메인별 옵션. treaty:{chrClsCd:'010202'(한)/'010203'(영)} english_law:{mst,lawName} ministry:{ministry(search 때와 같은 부처)} prec/constitutional/admin_appeal/interpretation:{caseName}
설치 중 법제처 API 키를 묻습니다 (0단계에서 발급받은 honggildong 같은 키, 민감정보로 저장). 비워 두면 공용 한도로 동작합니다. 이후 Claude Code에 자연어로 질문하면("근로기준법 제74조 알려줘", "민법 제750조 판례 검증해줘") korean-law MCP 도구가 자동 호출됩니다. 새 버전은 한 줄로 최신화:
code
/plugin marketplace update korean-law-marketplace
플러그인은 공개 서버 https://mcp.gomdori.app/law 에 연결합니다(내 컴퓨터에 아무것도 설치하지 않음). 키는 apikey 헤더로 보냅니다. 서버를 거치지 않으려면 방법 4의 로컬 설치를 쓰세요.
Troubleshooting: Permission denied (publickey) 에러
설치 중 git@github.com: Permission denied (publickey).가 뜨면 설치기가 GitHub에 SSH로 접속했는데 SSH 키가 없는 경우 (처음 Git을 쓰는 비개발자·법률 실무자에게 자주 발생). 둘 중 하나로 해결:
HTTPS로 강제 우회 (가장 간단, 추천): 아래 한 줄 실행 후 다시 /plugin install. 설치 후에도 그대로 둬도 무방 (HTTPS clone이 항상 동작)
설치 마법사가 API 키 입력 → AI 클라이언트 선택 → 설정 파일 자동 등록까지 한 번에 처리합니다.
Claude Desktop, Claude Code, Cursor, VS Code, Windsurf, Gemini CLI, Zed, Antigravity를 지원합니다.
현재 폴더에 쓰는 설정(Claude Code .mcp.json, VS Code .vscode/mcp.json)은 git에 커밋될 수 있어 키를 평문으로 넣지 않습니다.
Claude Code는 ${LAW_OC} 참조를 넣으니 셸 설정에 export LAW_OC=발급받은키를 추가하고, VS Code는 처음 실행할 때 키를 묻습니다.
# 설치
npm install --ignore-scripts --omit=optional -g korean-law-mcp
# 인증키 설정 (honggildong을 본인 키로 바꾸세요)export LAW_OC=honggildong # Mac/Linuxset LAW_OC=honggildong # Windows CMD$env:LAW_OC="honggildong"# Windows PowerShell# 사용 예시
korean-law "민법 제1조"# 자연어로 바로 조회
korean-law search_law --query "관세법"# 도구 직접 호출
korean-law list # 전체 도구 목록
korean-law list --category 판례 # 카테고리별 필터
korean-law help search_law # 도구별 도움말
API 키 전달 방법 정리
여러 방법으로 인증키를 전달할 수 있습니다. 위에서부터 우선 적용됩니다:
방법
사용법
언제 쓰나
URL에 포함
주소 끝에 ?oc=내키
웹 클라이언트에서 가장 간편
HTTP 헤더
apikey: 내키
프로그래밍으로 연동할 때
환경변수
LAW_OC=내키
로컬 설치(방법 4, 5)
도구 파라미터
apiKey: "내키"
특정 요청만 다른 키 쓸 때
키 없이 공개 서버(mcp.gomdori.app/law)를 쓰면 무키 사용자 전원이 공유하는 서버 키 한도를 거침. 자체 키를 넘기면 이 한도와 무관함(무료 발급: https://open.law.go.kr).
법제처 API 프로토콜 설정
법제처 API 호출은 기본 HTTPS. 사내망·폐쇄망 등 인증서 검증이 어려운 환경에서는 LAW_API_PROTOCOL=http로 HTTP 호출 가능. 허용값은 http, https이며 설정하지 않거나 다른 값이면 https. MCP 클라이언트 설정의 env 블록에 넣는 방식이 가장 명확합니다:
별도 웹 프록시를 거쳐야 한다면 프록시 주소를 설정합니다(국세청 판례 본문 fallback·국세청 법령해석 본문의 외부 HTTPS 연결에 적용). Windows 시스템 환경변수는 관리자 권한 터미널에서 setx로 등록하고, 적용 후 Windows 또는 Node.js 프로세스를 재시작하세요:
execute_tool(tool_name="search_law_bulk"): 법령명 배열 + previous={법령ID: 직전 MST}이면 MST가 바뀐 법령만 반환
개정안 신·구조문대비표
legal_analysis(mode="amendment_table"): 법령명 + 개정 조문 전문 → 현행 자동 대조(바뀐 곳 밑줄, 같은 부분 ----, (생 략)·<신 설>). 조례는 currentText, 로컬 실행은 outputPath로 한글(.hwpx) 저장
판례 전문(축약 해제)
get_decision_text(..., full=true)
도구 구조 (10개)
노출 도구는 10개. chain_* 8개는 legal_research의 task로, 분석 기능 4개는 legal_analysis의 mode로 통합. 나머지 전문 도구는 discover_tools → execute_tool로 접근하며, 기존 도구명 직접 호출도 하위호환으로 동작.
구분
도구
설명
리서치 (1)
legal_research
다단계 법령 리서치: task 8종 선택 (아래 표)
정밀분석 (1)
legal_analysis
검증·분석: mode 4종 선택 (아래 표)
법령 (3)
search_law
법령 검색 → lawId, MST 획득
get_law_text
조문 전문 조회 (jo="부칙"으로 부칙)
get_annexes
별표/서식 조회 (금액표·요율표·별지서식, date 로 그날 시행 버전의 별표)
자치법규 (1)
ordinance_radar
조례 정비 레이더: 근거 상위법 개정 자동 대조
통합 (2)
search_decisions
23개 도메인 통합 검색 (판례·헌재·조세심판·관세·국세청·고용노동부·행정안전부 해석·중앙부처 1차 해석(39개 부처)·공정위·노동위·산재보험재심사·고용보험심사·해석례·행심·개인정보위·권익위·소청심사·학칙·공사공단·공공기관·조약·영문법령)
42개 API → 10개 도구: 법령, 판례, 행정규칙, 자치법규, 헌재결정, 조세심판, 관세해석, 국세청 해석례, 조약, 학칙/공단/공공기관 규정, 법령용어
MCP + CLI: Claude Desktop에서도, 터미널에서도 같은 도구 사용
법률 도메인 특화: 약칭 자동 인식(화관법 → 화학물질관리법), 조문번호 변환(제38조 ↔ 003800), 3단 위임 구조 시각화
현행성 안내: 검색 결과에 [현행]/⚠️[연혁-과거버전] 라벨, 시행예정 개정·제명변경 병기, 폐지 법령은 폐지 사유와 후속 통합 규정 안내
과거 시점 그대로: 법령ID로 버전을 이어 붙여 법령명이 바뀌기 전 시절까지 조회
실패를 "없음"으로 답하지 않음: 조회 실패·점검 페이지·예산 초과는 [NOT_FOUND] 등 명시 마커로 구분
별표/별지서식 본문 추출: HWPX·HWP·PDF·XLSX·DOCX 자동 변환 (kordoc 엔진)
8개 체인 + 9개 시나리오: 기본 체인에 상황별 확장 분석 자동 추가 (과태료 감경, 관세 통관, 위임입법 감시 등)
23개 도메인 통합 검색: search_decisions 하나로 판례·헌재·조세심판·공정위·노동위 등 즉시 접근
캐시: 검색 1시간, 조문 24시간 TTL
원격 엔드포인트: 설치 없이 https://mcp.gomdori.app/law로 바로 사용 (구 korean-law-mcp.fly.dev/mcp도 하위호환 유지)
HTTP·실행 경계 설정
HTTP 기본 바인딩은 MCP_HTTP_HOST=127.0.0.1, 프록시 신뢰 기본값은 TRUST_PROXY=false입니다. 외부 바인딩은 MCP_AUTH_TOKEN을 설정해야 하며, 의도적으로 공개할 때만 MCP_ALLOW_UNAUTHENTICATED_REMOTE=1을 명시합니다. 프록시 뒤에서는 TRUST_PROXY=1처럼 정확한 hop 수를 설정하세요.
브라우저(웹) 클라이언트를 쓸 때는 ALLOWED_ORIGINS를 설정하세요. MCP 명세가 요구하는 Origin 검증(DNS rebinding 방어) 때문에, Origin 헤더가 붙은 요청은 ALLOWED_ORIGINS 화이트리스트(콤마 구분)에 있는 출처만 통과합니다. ALLOWED_ORIGINS를 비워 두면 CORS_ORIGIN이 대신 기준이 됩니다(*면 모든 출처, 아니면 그 출처 하나). 둘 다 설정하지 않으면 브라우저 요청은 모두 차단되고 시작 시 안내가 출력됩니다. ALLOWED_ORIGINS를 설정하면 CORS_ORIGIN은 출처 판정에 쓰이지 않습니다.
ALLOW_QUERY_API_KEY=0이면 URL 쿼리(?oc=키)로는 API 키를 전달할 수 없습니다. 쿼리 키는 프록시/엣지 액세스 로그에 평문으로 남으므로 폐쇄망이나 로그 수집 환경에서 권장합니다. 헤더(apikey·law_oc 등) 전달은 계속 동작합니다.
ACCESS_LOG=1이면 요청 로그를 기록합니다. 쿼리스트링의 oc= API 키 유출을 막기 위해 경로만 기록합니다.
RATE_LIMIT_RPM=0은 IP별 제한만 끕니다. MCP_MAX_BATCH_CALLS(기본 20), 요청 본문, upstream 시도/응답 본문, 도구 응답 제한은 계속 적용됩니다. FALLBACK_DAILY_CAP은 서버 키 폴백의 하루 총량 캡(0이면 비활성, 기본).
MCP_MAX_BODY_BYTES, MCP_MAX_UPSTREAM_REQUESTS(기본 48), MCP_MAX_UPSTREAM_BODY_BYTES, MCP_MAX_TOTAL_UPSTREAM_BODY_BYTES, MCP_MAX_TOOL_RESPONSE_CHARS는 시작 시 정수로 검증되며 잘못된 값은 서버 시작을 실패시킵니다. 기존 MCP_BODY_LIMIT=100kb도 호환됩니다.
MCP_CHAIN_DEADLINE_MS(기본 45초): 체인 한 건의 시간 한도. 만료되면 받은 갈래까지 조립한 부분 결과를 반환하고 못 받은 자리는 마커로 표시.
LAW_USER_AGENT·LAW_REFERER: 법제처 호출에 붙는 User-Agent·Referer 기본값을 바꿀 때만 설정.
get_batch_articles는 최대 20개 법령·총 100개 조문으로 제한됩니다. HTTP 연결 종료 또는 MCP 취소는 fetch, 재시도 대기, 응답 본문 읽기까지 전파됩니다. JSON-RPC 배치 항목은 예산만 공유하고 취소 신호는 서로 분리됩니다.
publish 전 build/를 삭제하고 실제 pack 파일과 exports를 검증합니다. kordoc는 별표 PDF/HWP 파싱에 실제 사용되므로 유지하고, 필요한 pure-JS pdfjs-dist@4.10.38만 일반 의존성으로 고정합니다. 플러그인·문서·Docker 설치는 --omit=optional --ignore-scripts로 OCR/ML/native 선택 의존성을 제외합니다. CI·게시 workflow는 개발 도구의 optional binding을 설치하되 script는 끈 상태로 검증한 뒤, production graph로 prune하고 PDF 별표 smoke test를 실행합니다. transitive scanner 경고는 실제 도달 가능한 서버 경로와 구분해 평가합니다.
Q. Claude·ChatGPT에서 한국 법령·판례를 검색하려면?
이 MCP 서버를 연결합니다. Claude.ai는 커넥터 주소 https://mcp.gomdori.app/law?oc=본인키 하나면 되고, Claude Desktop·Cursor·Windsurf·Zed는 설치 및 사용법, ChatGPT는 연결 영상을 따르세요.
Q. 무료인가요?
MIT 라이선스 오픈소스입니다. 필요한 법제처 Open API 인증키도 무료로 발급됩니다(0단계).
Q. AI가 지어낸 조문·판례를 걸러낼 수 있나요?legal_analysis(mode="verify_citations")가 답변 속 법령 조문과 판례 번호를 법제처 원문과 대조해 실존 여부와 내용 일치를 확인합니다. 판례가 아직 유효한지는 mode="cite_check"로 봅니다.
Q. 어디까지 조회되나요?
법령, 판례, 행정규칙, 자치법규(조례·규칙), 조약, 법령해석례(국세청 포함)와 별표·서식입니다. 과거 시점 법령과 폐지 법령의 후속 규정도 찾습니다.
Star History
데이터 출처
법령·판례·행정규칙·자치법규·조약·해석례 본문은 법제처 국가법령정보센터 OPEN API
(https://open.law.go.kr/)에서 조회합니다. 국세청 해석례는 국세법령정보시스템을 사용합니다.
법적 효력이 필요한 판단에는 반드시 국가법령정보센터 원문을 확인하세요. 이 도구는 조회
결과를 가공·요약할 수 있습니다.
API 인증키(LAW_OC)는 법제처에서 각자 발급받아야 하며, 발급받은 본인만 사용할 수
있습니다.