mcp-kr-legislation 사용법 — 130개 법률 도구로 Claude 법령 완전 무장하기
mcp-kr-legislation(ChangooLee) 설치부터 법제처 인증키 발급, 130개 도구 활용법까지 단계별로 정리했습니다. Claude를 법령 전문 AI로 바꾸는 가장 완전한 가이드.
법률 문서 작업에서 Claude를 진정한 법령 전문 AI로 만들고 싶다면 mcp-kr-legislation이 현재 한국어 법령 MCP 서버 중 가장 넓은 도구 커버리지를 제공합니다. 법제처 Open API를 130개 이상의 개별 MCP 도구로 래핑해, 조문 검색부터 행정규칙 탐색까지 Claude 채팅 한 줄로 처리할 수 있습니다. 이 가이드에서는 API 키 발급부터 Claude Desktop 연동, 실전 활용 팁까지 모두 다룹니다.
mcp-kr-legislation이 필요한 이유
변호사·법무팀·스타트업 법무 담당자가 법령을 검토할 때 가장 시간을 많이 쓰는 일이 최신 법령 원문 확인입니다. 국가법령정보센터 웹사이트에서 직접 검색하면 빠르지만, 반복 작업이 많고 조문 간 상호 참조를 추적하기 어렵습니다. Claude에 법령 MCP 서버를 연결하면 다음이 가능해집니다.
- 자연어로 “근로기준법 제54조가 뭐야?”를 물으면 원문 바로 조회
- “이 계약서에 위반되는 법령이 있어?”라는 질문에 조문 단위 분석
- 여러 법령의 관련 조문을 한 번에 교차 검색
- 판례·행정규칙·시행령까지 통합 탐색
특히 130개 도구는 단순한 법령 본문 검색을 넘어, 법령 체계 전반을 다루기 때문에 법령 개정 이력이나 소관 부처별 필터링 같은 심화 질문도 처리할 수 있습니다.
mcp-kr-legislation vs 다른 한국 법령 MCP 서버 비교
/category/law에서 확인할 수 있는 한국 법령 관련 MCP 서버들을 간략히 비교하면 다음과 같습니다.
| 서버 | 도구 수 | API 키 필요 | 주요 특징 |
|---|---|---|---|
| mcp-kr-legislation (ChangooLee) | 130개+ | 필요 | 법제처 전 엔드포인트 망라, 가장 넓은 커버리지 |
| 한국 법령 MCP | 17개 | 필요 | 법제처 42개 API 중 핵심 래핑, 빠른 설치 |
| 한국 법령 MCP 서버 | 일부 | 필요 | 법령·판례·행정규칙 통합 검색 |
| 한국 계약서 자동생성 MCP | 9종 계약서 | 불필요 | 계약서 생성 특화, 법령 검색 아님 |
도구 수가 많다고 무조건 좋은 것은 아닙니다. 단순한 법령 본문 조회가 목적이라면 17개 도구짜리 서버로도 충분합니다. 130개 도구가 빛나는 상황은 법령 체계 분석, 조문 단위 교차 참조, 개정 이력 탐색 같은 심화 작업입니다.
준비물
설치 전에 아래 세 가지를 확인하세요.
- Node.js 18 이상 —
node -v로 버전 확인 - Git — 저장소 클론에 필요
- 법제처 Open API 인증키 — 아래 1단계에서 발급
단계별 설치 방법
1단계. 법제처 Open API 인증키 발급
법제처 Open API 포털(open.law.go.kr)에 접속합니다.
- 우측 상단 회원가입 완료
- 로그인 후 Open API 신청 메뉴 이동
- 활용 목적 입력 후 신청 완료 → 이메일로 인증키 수신
인증키는 보통 즉시 발급됩니다. 이메일 수신함을 확인하고, 발급된 **인증키(영문+숫자 문자열)**를 메모해 두세요.
2단계. 저장소 클론 및 의존성 설치
터미널을 열고 아래 명령어를 실행합니다. (저장소 이름은 스펙에 명시된 ChangooLee 프로젝트 기준입니다. GitHub에서 최신 저장소 URL을 확인하세요.)
# 적절한 디렉토리로 이동
cd ~/mcp-servers
# ChangooLee/mcp-kr-legislation 저장소 클론
git clone https://github.com/ChangooLee/mcp-kr-legislation.git
# 프로젝트 디렉토리로 이동
cd mcp-kr-legislation
# 의존성 설치
npm install
설치가 완료되면 node_modules 디렉토리가 생성됩니다.
3단계. 환경 변수 설정
프로젝트 루트에 .env 파일을 생성하고 발급받은 인증키를 입력합니다.
# .env 파일 생성
touch .env
.env 파일을 열어 아래와 같이 작성하세요.
LAW_API_KEY=여기에_발급받은_인증키_입력
인증키는 절대 Git에 커밋하지 마세요. .gitignore에 .env가 포함되어 있는지 반드시 확인하세요.
4단계. 서버 빌드 (필요 시)
TypeScript 기반 프로젝트라면 빌드가 필요할 수 있습니다.
npm run build
빌드 완료 후 dist 또는 build 디렉토리가 생성됩니다. README에서 진입점 파일명(예: dist/index.js)을 확인해 두세요.
5단계. Claude Desktop 설정 파일 수정
Claude Desktop의 MCP 설정 파일을 편집합니다.
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json
아래 예시를 참고해 mcpServers 블록에 추가합니다. command와 args의 경로는 실제 클론한 위치로 변경하세요.
{
"mcpServers": {
"mcp-kr-legislation": {
"command": "node",
"args": ["/절대경로/mcp-kr-legislation/dist/index.js"],
"env": {
"LAW_API_KEY": "여기에_발급받은_인증키_입력"
}
}
}
}
경로에 공백이 포함되면 오류가 발생할 수 있습니다. 경로에 공백 없는 위치를 권장합니다.
6단계. Claude Desktop 재시작 및 확인
Claude Desktop을 완전히 종료했다가 다시 시작합니다. 채팅창에서 아래처럼 테스트해 보세요.
근로기준법 제54조의 내용을 알려줘.
법제처에서 실시간으로 조문을 가져와 답변한다면 정상 동작입니다.
데이터 흐름 이해하기
아래 다이어그램은 mcp-kr-legislation의 데이터 흐름을 보여줍니다.
사용자 질문
│
▼
Claude Desktop (LLM)
│ MCP 프로토콜(stdio)
▼
mcp-kr-legislation 서버
│ HTTP 요청 + 인증키
▼
법제처 Open API (open.law.go.kr)
│ JSON 응답
▼
mcp-kr-legislation 파싱·정제
│
▼
Claude Desktop → 사용자에게 법령 정보 전달
MCP 서버는 Claude와 법제처 API 사이의 통역사 역할을 합니다. Claude가 “근로기준법 조회” 요청을 보내면, 서버가 적절한 API 엔드포인트를 호출하고 결과를 Claude가 읽기 좋은 형식으로 돌려줍니다.
흔한 오류와 해결 방법
| 오류 메시지 | 원인 | 해결 방법 |
|---|---|---|
API key not found / 인증 실패 | 인증키가 잘못 입력됨 | .env 또는 설정 파일의 인증키 재확인 |
Cannot find module | 빌드 안 됨 또는 경로 오류 | npm run build 재실행, 설정 파일 경로 점검 |
spawn ENOENT | node 경로 문제 | which node로 절대 경로 확인 후 command에 사용 |
| 도구 목록이 보이지 않음 | Claude Desktop 재시작 필요 | 완전 종료 후 재시작 |
| 응답 없음 / 타임아웃 | 법제처 API 서버 점검 중 | open.law.go.kr 공지사항 확인 |
spawn ENOENT 오류 해결 예시:
{
"mcpServers": {
"mcp-kr-legislation": {
"command": "/usr/local/bin/node",
"args": ["/Users/yourname/mcp-servers/mcp-kr-legislation/dist/index.js"],
"env": {
"LAW_API_KEY": "인증키"
}
}
}
}
which node 명령어로 실제 Node.js 경로를 확인해 command에 절대 경로를 사용하면 대부분 해결됩니다.
실전 활용 예시
130개 도구가 있으면 어떤 질문이 가능할까요?
법령 본문 조회
"전자상거래법 제3조부터 제7조까지 원문을 보여줘."
법령 간 비교
"개인정보보호법과 정보통신망법에서 손해배상 관련 조문을 각각 찾아 비교해줘."
개정 이력 탐색
"최저임금법이 2020년 이후 몇 차례 개정됐는지 알려줘."
소관 부처 검색
"방송통신위원회가 소관하는 법령 목록을 조회해줘."
이런 복합 질문들이 웹 검색 없이 법제처 원문 데이터로 처리된다는 점이 가장 큰 장점입니다.
함께 쓰면 좋은 법령 MCP 서버
mcp-kr-legislation만으로 대부분 해결되지만, 목적에 따라 다른 서버를 보완적으로 사용할 수 있습니다.
- 한국 법령 MCP: 법제처 42개 API를 17개 도구로 간결하게 래핑. 빠른 설정을 원할 때 적합.
- 한국 법령 MCP 서버: 판례와 행정규칙 검색에 특화.
- 한국 계약서 자동생성 MCP: 법령 검색 결과를 바탕으로 계약서까지 자동 생성하고 싶을 때.
/servers에서 더 많은 MCP 서버를 둘러보거나, 법률 카테고리에서 한국 법령 관련 서버 전체 목록을 확인하세요.
자주 묻는 질문
mcp-kr-legislation은 무료로 사용할 수 있나요?
mcp-kr-legislation 자체는 오픈소스(GitHub)이므로 무료입니다. 단, 연동하는 법제처 Open API는 공공 API로 무료 발급되며, 사용량 제한이 있을 수 있으므로 open.law.go.kr에서 약관을 확인해 주세요.
130개 도구가 모두 무엇인가요?
법령 본문 조회, 조문 검색, 시행령·시행규칙 탐색, 판례 검색, 행정규칙 조회 등 법제처 API가 제공하는 다양한 엔드포인트를 개별 MCP 도구로 래핑한 것입니다. 정확한 도구 목록은 저장소의 README 또는 src/tools 디렉토리에서 확인하세요.
법제처 API 키 발급에 시간이 얼마나 걸리나요?
법제처 Open API 활용 신청은 보통 즉시 승인되며, 이메일로 인증키를 받습니다. 빠르면 수 분 내 발급됩니다.
Claude Code(터미널)와 Claude Desktop 중 어느 환경에서 사용하나요?
mcp-kr-legislation은 stdio 방식의 MCP 서버입니다. Claude Desktop의 설정 파일에 등록해 사용하는 것이 기본이며, Claude Code에서도 MCP 서버 설정을 통해 연동할 수 있습니다.
기존 korean-law-mcp와 무엇이 다른가요?
한국 법령 MCP는 법제처 42개 API를 17개 도구로 래핑한 서버입니다. mcp-kr-legislation(ChangooLee)은 더 많은 엔드포인트를 130개 이상의 도구로 제공해 훨씬 세밀한 법령 탐색이 가능합니다. 두 서버를 함께 등록해 보완적으로 사용할 수도 있습니다.
Windows에서도 사용할 수 있나요?
Node.js와 Git이 설치된 환경이라면 Windows에서도 동일한 설치 절차를 따를 수 있습니다. 설정 파일 경로(claude_desktop_config.json)가 운영체제마다 다르므로 공식 Claude Desktop 문서를 참고해 주세요.
다음 단계
mcp-kr-legislation을 성공적으로 설치했다면, 다음 단계로 넘어가 보세요.
- 다른 법령 MCP 서버 추가: /guides에서 한국 법령 MCP 관련 가이드를 더 찾아볼 수 있습니다.
- 계약서 자동화 연결: 한국 계약서 자동생성 MCP를 함께 설치하면 법령 조회부터 계약서 작성까지 원스톱으로 처리할 수 있습니다.
- 나만의 법령 워크플로 만들기: Claude의 Projects 기능과 결합하면 반복적인 법령 검토 작업을 대폭 자동화할 수 있습니다.
새로운 한국어 법령 MCP 서버를 발견했다면 /submit 페이지에서 제보해 주세요. MCP모아가 더 완전한 디렉토리가 되는 데 도움이 됩니다.