Korean Law ALIO MCP

국가법령정보센터와 알리오의 공공기관 내부규정을 검색·비교·분석하는 MCP 입니다.

법제처 87개 + ALIO 공공기관 내부규정 23개 + ALIO 보고서형 공시(단체협약·임금협약·노사협의회 각 5개) 15개 = 총 125개 MCP 도구가 분석을 합니다.

1,600 법률, 10,000 행정규칙, 수만건 판례, 344개 공공기관 35,000 내부규정을 검색하고 비교 및 분석한 결과를 AI에게 주어 좋은 답변을 만들도록 도와줍니다.

본 프로젝트는 chrisryugj/korean-law-mcp 에서 파생되어 만들어 졌습니다.

English

만든 이유

전체 법령에 대해서 korean-law-mcp 의 도움으로 공공기관의 업무처리에 도움이 많이 되고 있습니다. 다시 한번 chrisryugj 님께 감사드립니다.

여기에 공공기관의 내부규정까지 활용되면 더욱 큰 효과가 있을 것이라 생각되었습니다. 그래서 ALIO 의 공공기관 내부규정 데이터를 참고해서 추가 개발을 하게 되었습니다.

법에 대한 접근이 어려운 사람들과 내부규정 관리로 고생하는 전국의 공공기관 직원들에게 도움이 되었으면 좋겠습니다.

v1.0.8 — 공공기관 규정과 법제처 법령을 한 번에

원작 87개 법제처 도구 위에 ALIO 공공기관 23개 (내부규정) + 15개 (단체협약·임금협약·노사협의회 각 5개) + 두 영역을 잇는 연계 도구 3개 를 통합 — 125개 도구가 법제처 데이터 + 35,000건 공공기관 내부규정 + 보고서형 공시(단체협약·임금협약·노사협의회)를 자연어로 검색·비교·분석.

개발 사항

• ALIO 23개 도구 — 344개 공공기관 35,000건 내부규정 통합
• ALIO 보고서형 공시 15개 도구 (v1.1.0~v1.3.0) — 단체협약·임금협약·노사협의회 의결사항 각 5개 (search/list/get/search_text/compare). 단일 팩토리(tools/alio-report/)로 생성
• 공공기관과 법제처 연계 3개 도구 — 공공기관 규정과 법제처 법령을 잇는 연계 도구
  • 공공기관 규정에서 인용된 상위 법령 자동 추출 + 법제처에서 각 법령 정보 자동 조회
  • 법제처 법령을 입력하면, 그 법령을 근거로 삼는 공공기관 규정을 전국에서 역검색
  • 단일 규정 안에서 조문끼리 어떻게 인용·참조하는지 자동 분석
• 설치 마법사 — npx korean-law-alio-mcp setup (API 키 → 운영 모드 → 클라이언트 다중 선택 → 설정 자동 등록)
• fly.io 원격 MCP 운영 — https://korean-law-alio-mcp.fly.dev (125개 도구 + ALIO 데이터, 서버가 죽지 않게 최대한 노력)

예시 — 📜 법제처의 법률정보와 🏢 알리오의 공공기관 내부규정을 잇는 자연어 질의

"OO진흥원 인사규정과 관련된 상위 법령을 알려줘"

→ AI 가 자연어 질의를 받으면 자동으로 다음을 수행:

• 해당 기관의 인사규정 본문을 분석해 인용된 상위 법령을 자동 추출
• 추출된 각 법령의 식별자를 법제처 OpenAPI 에서 자동 조회

결과 예시:

"인사규정 본문에서 약 10여 건의 상위 법령 인용을 찾았습니다 (예: 인사·근로 관련 일반 법령, 안전·보건 관련 법령, 양성평등 관련 법령 등). 각 법령의 식별자가 첨부되어 후속 조회 가능."

"OO공단의 OOO지침이 관련 법령의 위임 범위를 벗어나지 않았는지 검토해줘"

→ AI 가 자연어 질의를 받으면 자동으로 다음을 수행:

• 지침 본문에서 위임 근거 조문 (모법 + 시행령/시행규칙) 자동 추출
• 모법의 위임 조항 본문을 법제처 OpenAPI 에서 조회 — 위임된 사항/한계 확인
• 지침의 각 조항을 모법 위임 범위와 대조해 분류 (범위 내 / 초과 가능성 / 위임 근거 미상)

결과 예시:

"지침의 X조·Y조 는 모법 Z조 의 위임 범위 안. 한편 지침 W조 는 위임 근거가 명시되지 않았거나 모법이 정한 한도를 일부 초과할 가능성이 있어 검토 필요. 각 항목마다 모법 조문 인용을 함께 제시."

공공기관 규정 정비, 감사, 위임범위 일탈 점검까지 한 번에 추적.

설치 및 사용법

사전 준비 1: API 키 발급 (무료, 1분)

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

1. 법제처 Open API 신청 페이지 접속
2. 회원가입 후 로그인
3. "Open API 사용 신청" 버튼 클릭
4. 신청서 작성 → 인증키(OC) 발급 (이메일 ID 형식)

아래 모든 예시의 your-api-key-here 는 본인 발급 키로 교체하세요.

사전 준비 2: Node.js 설치 (권장)

• 로컬 MCP 서버 사용 시 — Node.js 설치 권장 (Node.js 20 이상 필요) → 설치는 귀찮지만 안정적 답변 + 속도 빠름
• 원격 MCP 서버 사용 시 (Claude.ai 웹 또는 Claude Desktop 원격) — Node.js 불필요 → 하지만 긴 요청 timeout + 느림

macOS:

# 옵션 A — Homebrew (권장)
brew install node

# 옵션 B — 공식 인스톨러
# https://nodejs.org/ko/download → LTS 버전 다운로드

Windows:

# https://nodejs.org/ko/download 에서 LTS 버전 다운로드

Linux (Ubuntu / Debian):

curl -fsSL https://deb.nodesource.com/setup_20.x | sudo bash -
sudo apt install -y nodejs

확인:

node --version    # v20.x.x 이상이 떠야 함
npx --version

⭐ 방법 1: Claude Desktop / Cursor / Windsurf — npx 자동 설치 (안정적, 권장)

[!IMPORTANT] 설치는 이 한 줄로 끝.

npx korean-law-alio-mcp setup

설치 마법사가 차례로:

• API 키 입력 — 사전 준비 1 에서 발급한 키
• 운영 모드 선택 — 로컬 (권장) / 원격 중 선택
• 클라이언트 선택 — Claude Desktop / Cursor / Windsurf / VS Code / Claude Code (다중 선택 가능)
• ALIO 데이터 ~300MB 자동 다운로드 + 압축 해제 (1-2분)

저장 후 클라이언트 완전 재시작 해야 적용됨.

참고 — 그 외 옵션:

• npx korean-law-alio-mcp fetch-data — ALIO 데이터만 별도 갱신 (다운로드 성공 후 안전 교체, 실패 시 기존 보존)
• npx korean-law-alio-mcp uninstall — 클라이언트 설정 + ALIO 데이터 + npx 캐시 일괄 정리 (기본 No prompt)

⭐ 방법 2: https://claude.ai/ 웹에서 바로 사용 (간편함)

https://claude.ai/ 에서 커스텀 커넥터 추가.

[!IMPORTANT] 커넥터 추가 방법:

1. https://claude.ai/ 로그인
2. 사이드바 하단 본인 이름 → "설정" → "커넥터"
3. "커스텀 커넥터" 영역 → "커스텀 커넥터 추가"
4. 아래 입력 (your-api-key-here 는 본인 키로 교체):
   • 이름: korean-law-alio (자유)
   • URL: https://korean-law-alio-mcp.fly.dev/mcp?oc=your-api-key-here
5. "추가" → 등록 완료

도구 활성화 (중요): 등록한 커넥터 "구성" 클릭 → 도구 목록에서 모든 도구를 "항상 사용" 으로 설정. 매번 승인 없이 AI가 바로 호출 가능.

⚠️ 주의사항: Claude Desktop 에서는 커스텀 커넥터로 추가 시 동작 중 오류가 발생합니다. Claude Desktop 은 반드시 방법 1 로 추가해야 합니다.

방법 3: Claude Code 플러그인 — /plugin install 한 줄

본인 API 키를 먼저 환경변수로 export 해두면 설치 시 자동 주입됩니다.

export LAW_OC=your-api-key-here   # ~/.zshrc 또는 ~/.bashrc 에 추가하면 영구 적용

이후 Claude Code 안에서:

/plugin marketplace add scvcoder/korean-law-alio-mcp
/plugin install korean-law-alio@korean-law-alio-marketplace

설치 후 자동으로 npx -y korean-law-alio-mcp 가 실행되며 LAW_OC 가 전달됩니다. 별도 설정 파일 편집 불필요.

방법 4: 터미널(CLI)에서 직접 사용

개발자라면 터미널에서 직접 법령·공공기관 규정을 검색할 수 있습니다.

# 1) 패키지 글로벌 설치 (코드 ~250KB)
npm install -g korean-law-alio-mcp

# 2) ALIO 데이터 다운로드 (~300MB, 1-2분) — ~/.korean-law-alio-mcp/data/alio/ 에 저장
korean-law-alio-mcp fetch-data

# 3) 인증키 설정 (your-api-key-here 를 본인 키로 바꾸세요)
export LAW_OC=your-api-key-here     # Mac/Linux
set LAW_OC=your-api-key-here        # Windows CMD
$env:LAW_OC="your-api-key-here"    # Windows PowerShell

# 사용 예시
korean-law-alio "민법 제1조"                                # 법제처 자연어
korean-law-alio "OO진흥원 인사규정"                         # ALIO 자연어
korean-law-alio "OO진흥원 인사규정과 관련된 상위 법령"      # 두 영역 연계
korean-law-alio "공공기관 휴직 규정 비교해줘"                # ALIO 기관간 비교
korean-law-alio search_law --query "관세법"                 # 도구 직접 호출
korean-law-alio list                                        # 전체 125개 도구 목록
korean-law-alio list --category ALIO                        # 카테고리별 (ALIO/판례/법령검색 등)
korean-law-alio help search_law                             # 도구별 도움말
korean-law-alio                                             # REPL (대화형)

ALIO 도구는 사용자 자연어 그대로 — 비교 대상 기관을 환경변수에 박아두지 않음. "A·B·C 기관과 비교", "랜덤", "전체" 같이 자유롭게 표현하면 LLM 이 알아서 호출.

API 키 전달 방법 정리

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

사용 예시

법제처 도구 — 법령·판례·해석례

"민법 제1조 알려줘"
→ AI 가 법령 검색 → 해당 조문 자동 조회

"음주운전 처벌 기준"
→ AI 가 관련 법령 + 판례 + 해석례를 자동으로 종합 분석

"근로기준법 제74조 해석례"
→ AI 가 해당 조문 + 정부 해석례를 자동 매칭

ALIO 공공기관 규정 도구

"OO진흥원 인사규정 보여줘"
→ AI 가 정식 기관명을 자동 매칭 → 해당 기관 규정 목록 표시

"공공기관 휴직 규정 비교해줘"
→ AI 가 수집된 공공기관 전체에서 휴직 관련 규정을 자동 비교

"우리 기관에 없는 동종 기관 규정"
→ AI 가 동종 기관 보유 규정 - 자기 기관 보유 규정 = 벤치마킹 후보 자동 추출

법제처와 ALIO 를 연결하는 도구

공공기관 내부규정은 본질적으로 상위 법제처 법령에서 위임/근거를 받습니다. 두 영역을 잇는 자연어 질의도 자동 처리:

"OO진흥원 인사규정과 관련된 상위 법령을 알려줘"
→ AI 가 규정 본문에서 인용된 상위 법령을 자동 추출
   + 법제처에서 각 법령 정보를 자동 조회

"OO공단의 OOO지침이 근로기준법을 준수하는지 검토해줘"
→ AI 가 35,000건 공공기관 규정에서 해당 법령 인용 위치를 역검색
   → 매칭된 지침의 인용 컨텍스트 + 기관별 그룹 표시

도구 구조 (125개)

전체 도구 상세 (이름·파라미터·예시) 는 docs/API.md 참고.

주요 특징

• 125개 도구 통합 — 법제처 87 + ALIO 내부규정 23 + ALIO 보고서형 공시 15 (단체협약·임금협약·노사협의회)
• 두 영역 연계 — 공공기관 규정의 인용 법령 자동 추출 + 상위법 기반 ALIO 역검색 + 조문간 인용 그래프
• 자연어 라우팅 — 정식 기관명 자동 매칭 (수집된 344개 기관), 두 영역 자동 분기
• MCP + CLI — Claude Desktop·Cursor·Windsurf 에서도, 터미널에서도 같은 도구 사용
• 법률 도메인 특화 — 약칭 자동 인식 (화관법 → 화학물질관리법), 조문번호 변환 (제38조 ↔ 003800), 위임 구조 시각화
• 별표·별지서식 본문 추출 — HWPX·HWP·PDF·XLSX·DOCX 자동 변환 (kordoc 엔진)
• 원격 + 로컬 모드 — https://korean-law-alio-mcp.fly.dev 즉시 사용 OR 자기 PC 에 데이터 보관 (korean-law-alio-mcp fetch-data)
• 자동 설치 마법사 — npx korean-law-alio-mcp setup
• 검증 — 168 cases 자동 테스트 (npm test — 빌드·라우터·CLI·ALIO·법제처)
• 라이선스 — MIT

환경 변수

전체 변수 + 예시는 .env.example 참고.

문서

감사의 말

본 프로젝트는 다음 분들 덕분에 가능했습니다:

• chrisryugj 님 — korean-law-mcp, kordoc 프로젝트를 만드시지 않았으면 이 프로젝트는 시작될 수 없었습니다. 진심으로 감사드립니다.
• jkg 님 — ALIO 공공기관 내부규정을 통합해 보자는 아이디어를 주셔서 감사합니다.

라이선스

MIT

Made by scvcoder