korean-law-mcp 0.2.7

MCP Server for Korean Law Open API

Korean Law MCP Server (대한민국 법령/판례 검색 MCP 서버)

이 프로젝트는 국가법령정보센터(Open API)를 활용하여 대한민국 법령, 판례, 헌재결정례, 행정규칙, 자치법규를 검색하고 상세 내용을 조회할 수 있는 MCP (Model Context Protocol) 서버입니다.

🚀 주요 기능

• 법령 (Statutes): 현행 법령 검색 및 조문 조회
• 판례 (Precedents): 대법원 및 각급 법원 판례 검색 및 판시사항, 판결요지 조회
• 헌재결정례 (Constitutional Court Decisions): 헌법재판소 결정례 검색 및 전문 조회
• 자치법규 (Autonomous Laws): 각 지자체 조례/규칙 검색 및 조문 조회
• 행정규칙 (Administrative Rules): 중앙행정기관 훈령/예규/고시 검색 및 내용 조회

🚀 빠른 시작 (Quick Start)

이 패키지는 uvx를 사용하여 설치 없이 즉시 실행할 수 있습니다.

uvx korean-law-mcp

또는 pip로 설치할 수 있습니다:

pip install korean-law-mcp

필수 조건

• 국가법령정보센터 Open API ID가 필요합니다. (회원가입 및 신청)
• 실행 시 환경 변수 OPEN_LAW_ID를 설정해야 합니다.

Quick Start

Windows Users (No Installation Required)

For users who do not have Python installed or prefer a simple setup:

1. Go to the Releases page.
2. Download the latest korean-law-mcp.exe.
3. Add the following to your Claude Desktop configuration file (C:\Users\YourName\AppData\Roaming\Claude\claude_desktop_config.json):

{
  "mcpServers": {
    "korean-law": {
      "command": "C:\\path\\to\\korean-law-mcp.exe",
      "env": {
        "OPEN_LAW_ID": "Your_Open_Law_ID"
      }
    }
  }
}

(Make sure to replace C:\\path\\to\\... with the actual path where you downloaded the file)

Developers / Python Users (pip)

If you have Python installed:

3. 환경 변수 설정

.env 파일을 생성하고 Open API ID를 설정해야 합니다. (또는 실행 시 환경변수로 주입)

# .env 파일 생성 (예시)
cp .env.example .env
# .env 파일 편집하여 OPEN_LAW_ID 입력

📚 제공 도구 (Tools)

이 서버는 다음과 같은 MCP 도구를 제공합니다.

도구 이름 (Tool)	설명 (Description)	인자 (Arguments)
search_korean_law	통합 법률 검색 도구입니다. 상황에 따라 스마트하게 동작합니다. 1. 특정 조문 검색: "고등교육법 제20조" -> 해당 조문의 전문을 즉시 반환합니다. 2. 통합 검색: "학교폭력" -> 법령, 판례, 행정규칙을 아우르는 검색 결과를 요약하여 반환합니다.	query: 검색어 또는 찾고 싶은 법령/조문명
read_legal_resource	법적 리소스(법령 전체, 판례 전문 등)의 상세 내용을 읽어옵니다. 검색 결과에서 확인한 Typed ID를 사용합니다. 자동으로 리소스 내의 타 법령 참조(예: "제5조 참조")를 감지하여 함께 보여줍니다.	resource_id: 리소스 ID (예: statute:12345, prec:67890)

• 한영 자동 변환: "Civil Act Article 103"와 같이 영문으로 검색해도 자동으로 "민법 제103조"로 변환하여 검색합니다. (지원: Civil Act, Criminal Act, Commercial Act 등 주요 법령)

Typed ID 시스템 참고

이 서버는 리소스를 고유하게 식별하기 위해 type:id 포맷을 사용합니다.

• statute:12345: 법령 (Statutes)
• prec:67890: 판례 (Precedents)
• admrul:54321: 행정규칙 (Administrative Rules)
• const:...: 헌재결정례
• ordin:...: 자치법규

또는 pipx를 사용하는 경우:

pipx run korean-law-mcp

또는 직접 Python으로 실행할 경우:

{
  "mcpServers": {
    "korean-law": {
      "command": "python3",
      "args": [
        "/absolute/path/to/korean-law-mcp/src/main.py"
      ],
      "env": {
        "OPEN_LAW_ID": "your_actual_api_id"
      }
    }
  }
}

---

개발자 정보: 소스 코드 확인 및 기여는 GitHub 저장소를 참고하세요.