🏛️ 한국 법률/판례 검색 MCP 서버

국가법령정보센터 Open API를 활용한 고성능 MCP (Model Context Protocol) 서버입니다.

AI 에이전트(Claude Desktop, Cursor 등)가 실시간으로 한국 법령, 판례, 행정규칙을 검색하고 분석할 수 있도록 합니다.

✨ 주요 기능

🔍 법령 검색

• 키워드 기반 법령 검색: 민법, 상법, 근로기준법 등 다양한 법령 검색

• 법령 상세 조회: 특정 법령의 전문(조문) 및 상세 정보 조회

• 법령 기본 정보: 소관부처, 공포일자, 시행일자, 개정 정보 포함

⚖️ 판례 검색

• 판례 키워드 검색: 손해배상, 계약, 부당해고 등 판례 검색

• 판례 상세 조회: 판결요지, 판시사항, 판례 전문 조회

• 법원 필터링: 대법원, 헌법재판소 등 법원별 필터링 지원

• 참조조문/판례: 관련 법령 및 참조 판례 정보 제공

📋 행정규칙 검색

• 행정규칙 검색: 각 부처의 행정규칙 검색

• 소관부처 정보: 제정일자, 시행일자 등 상세 정보

🚀 성능 최적화

• 전략적 캐싱: 법령/판례 데이터를 24시간 캐싱하여 API 호출 최소화

• 빠른 응답 속도: 캐시 기반 즉시 응답

• 안정적인 운영: 에러 핸들링 및 로깅 시스템

🎯 활용 사례

법률 전문가

• 계약서 검토: AI가 계약서를 분석하고 관련 법령 및 판례를 자동 참조

• 법률 자문: 특정 사안에 대한 관련 법령 및 판례를 즉시 조회

• 판례 연구: 유사 판례를 빠르게 검색하고 비교 분석

기업 법무팀

• 기업 컴플라이언스: 사업 관련 법령을 실시간 조회

• 노무 관리: 근로기준법 등 노동 관련 법령 및 판례 검색

• 소송 준비: 관련 판례 및 법령 자동 수집

스타트업/개발자

• 서비스 법률 검토: 개인정보보호법, 전자상거래법 등 관련 법령 확인

• 약관 작성: 관련 법령을 참조하여 약관 작성

• 법률 리스크 분석: AI가 서비스 기획서를 분석하고 관련 법률 리스크 파악

일반 사용자

• 법률 상담: AI 에이전트를 통한 기본적인 법률 정보 조회

• 권리 확인: 소비자 권리, 임차권 등 관련 법령 및 판례 검색

• 민원 준비: 행정심판, 소송 준비를 위한 법률 정보 수집

🛠️ 기술 스택

• MCP Framework: FastMCP

• Data Validation: Pydantic

• HTTP Client: Requests

• XML Parsing: xml.etree.ElementTree

• Caching: cachetools (24시간 TTL)

• Async Processing: asyncio

• Environment: Python-dotenv

📦 설치 및 설정

1) 의존성 설치

💡 uv를 사용하는 경우: uv sync

2) API 키 발급

국가법령정보센터 Open API 키를 발급받아야 합니다:

1. 국가법령정보센터 Open API 사이트 방문

2. 회원가입 및 로그인

3. 공동활용 서비스 > Open API 메뉴에서 API 신청

4. 승인 후 인증키(OC) 발급받기

📌 참고: API 키 발급은 보통 즉시 승인되며, 무료로 이용 가능합니다.

3) 환경 변수 설정

프로젝트 루트에 .env 파일을 생성하고 API 키를 설정합니다:

.env 파일 내용:

4) 서버 실행

또는 HTTP 서버로 실행:

🐳 Docker 실행

Docker를 사용하여 간편하게 실행할 수 있습니다:

🧰 사용 가능한 도구 (Tools)

1. health

• 설명: 서비스 상태 및 API 키 설정 확인

• 파라미터: 없음

• 반환: 서비스 상태 객체

2. search_law_tool

• 설명: 법령을 키워드로 검색

• 파라미터:

  • query (string, 필수): 검색할 법령 키워드 (예: '민법', '상법')

  • page (integer, 선택): 페이지 번호 (기본값: 1)

  • page_size (integer, 선택): 페이지당 결과 수 (기본값: 10, 최대: 50)

• 반환: 검색된 법령 목록 (법령명, 소관부처, 공포일자, 시행일자 등)

예시 응답:

3. get_law_detail_tool

• 설명: 특정 법령의 상세 정보 및 전문(조문) 조회

• 파라미터:

  • law_id (string, 필수): 법령 ID (법령 검색 결과에서 얻은 법령ID)

• 반환: 법령의 상세 정보와 모든 조문 내용

예시 응답:

4. search_precedent_tool

• 설명: 판례를 키워드로 검색

• 파라미터:

  • query (string, 필수): 검색할 판례 키워드 (예: '손해배상', '계약')

  • page (integer, 선택): 페이지 번호 (기본값: 1)

  • page_size (integer, 선택): 페이지당 결과 수 (기본값: 10, 최대: 50)

  • court (string, 선택): 법원 구분 (예: '대법원', '헌법재판소')

• 반환: 검색된 판례 목록

예시 응답:

5. get_precedent_detail_tool

• 설명: 특정 판례의 상세 정보 조회

• 파라미터:

  • precedent_id (string, 필수): 판례 일련번호

• 반환: 판례의 상세 정보 (판결요지, 참조조문, 판례 전문 등)

예시 응답:

6. search_administrative_rule_tool

• 설명: 행정규칙을 키워드로 검색

• 파라미터:

  • query (string, 필수): 검색할 행정규칙 키워드

  • page (integer, 선택): 페이지 번호 (기본값: 1)

  • page_size (integer, 선택): 페이지당 결과 수 (기본값: 10, 최대: 50)

• 반환: 검색된 행정규칙 목록

💡 사용 예시

Claude Desktop에서 사용

1. Claude Desktop 설정 파일 (claude_desktop_config.json) 수정:

2. Claude Desktop 재시작

3. Claude에게 질문:

   • "민법 제750조에 대해 알려줘"

   • "부당해고 관련 판례 찾아줘"

   • "개인정보보호법 검색해줘"

Cursor에서 사용

Cursor의 MCP 설정에서 위와 동일하게 추가하면 됩니다.

📁 프로젝트 구조

🚀 로드맵

• 법령 개정 이력 조회

• 법령/판례 전문 PDF 다운로드

• 자연어 기반 법령 해석

• 법령 비교 분석 기능

• 판례 유사도 분석

• 법률 용어 사전

💰 비즈니스 모델

이 MCP 서버는 판매용 제품으로 개발되었습니다:

타겟 고객

• 🏢 법률사무소/로펌: 법률 리서치 자동화

• 🏭 기업 법무팀: 컴플라이언스 관리

• 🚀 스타트업: 법률 리스크 분석

• 🎓 법학 연구자: 판례 연구 도구

가격 책정 (참고)

• Basic: 30만원 (기본 검색 기능)

• Pro: 100만원 (AI 분석 기능 추가)

• Enterprise: 200만원+ (커스터마이징, 기술 지원)

차별화 포인트

• ✅ 국가 공식 데이터 활용

• ✅ AI 에이전트 직접 통합

• ✅ 실시간 최신 법령/판례 조회

• ✅ 한국어 완벽 지원

• ✅ 복잡한 API 처리 자동화

📄 라이선스

MIT License

🤝 기여 및 문의

• 이슈: GitHub Issues

• 문의: law-mcp@example.com

• 문서: https://github.com/your-repo/korean-law-mcp

Made with ❤️ for Korean Legal Professionals

국가법령정보센터 Open API를 활용하여 개발되었습니다.