korean-law-alio-mcp

# Korean Law ALIO MCP [](https://www.npmjs.com/package/korean-law-alio-mcp) [](https://modelcontextprotocol.io) [](./LICENSE) [](./docs/API.md) [](#-alio-공공기관-규정-fork-의-차별점) --- 국가법령정보센터와 알리오의 공공기관 내부규정을 검색·비교·분석하는 MCP 입니다. 법제처 87개 + ALIO 공공기관 내부규정 23개 + ALIO 보고서형 공시(단체협약·임금협약·노사협의회 각 5개) 15개 = 총 125개 MCP 도구가 분석을 합니다. 1,600 법률, 10,000 행정규칙, 수만건 판례, 344개 공공기관 35,000 내부규정을 검색하고 비교 및 분석한 결과를 AI에게 주어 좋은 답변을 만들도록 도와줍니다. 본 프로젝트는 [chrisryugj/korean-law-mcp](https://github.com/chrisryugj/korean-law-mcp) 에서 파생되어 만들어 졌습니다. [English](./README-EN.md)  --- ## 만든 이유 전체 법령에 대해서 [korean-law-mcp](https://github.com/chrisryugj/korean-law-mcp) 의 도움으로 공공기관의 업무처리에 도움이 많이 되고 있습니다. 다시 한번 [chrisryugj](https://github.com/chrisryugj) 님께 감사드립니다. 여기에 공공기관의 내부규정까지 활용되면 더욱 큰 효과가 있을 것이라 생각되었습니다. 그래서 [ALIO](https://alio.go.kr/) 의 공공기관 내부규정 데이터를 참고해서 추가 개발을 하게 되었습니다. 법에 대한 접근이 어려운 사람들과 내부규정 관리로 고생하는 전국의 공공기관 직원들에게 도움이 되었으면 좋겠습니다. --- ## v1.3.1 — 공공기관 규정과 법제처 법령을 한 번에 원작 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 신청 페이지](https://open.law.go.kr/LSO/openApi/guideResult.do) 접속 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:** ```bash # 옵션 A — Homebrew (권장) brew install node # 옵션 B — 공식 인스톨러 # https://nodejs.org/ko/download → LTS 버전 다운로드 ``` **Windows:** ```powershell # https://nodejs.org/ko/download 에서 LTS 버전 다운로드 ``` **Linux (Ubuntu / Debian):** ```bash curl -fsSL https://deb.nodesource.com/setup_20.x | sudo bash - sudo apt install -y nodejs ``` **확인:** ```bash node --version # v20.x.x 이상이 떠야 함 npx --version ``` <a id="method-1"></a> ### ⭐ 방법 1: Claude Desktop / Cursor / Windsurf — `npx` 자동 설치 (안정적, 권장) > [!IMPORTANT] > **설치는 이 한 줄로 끝.** > > ```bash > 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. "추가" → 등록 완료 <img src="./claude-connector.png" alt="Claude 커스텀 커넥터 등록 화면" width="400"> **도구 활성화 (중요)**: 등록한 커넥터 "구성" 클릭 → 도구 목록에서 **모든 도구를 "항상 사용"** 으로 설정. 매번 승인 없이 AI가 바로 호출 가능. > ⚠️ **주의사항**: Claude Desktop 에서는 커스텀 커넥터로 추가 시 동작 중 오류가 발생합니다. Claude Desktop 은 반드시 [방법 1](#method-1) 로 추가해야 합니다. ### 방법 3: Claude Code 플러그인 — `/plugin install` 한 줄 본인 API 키를 먼저 환경변수로 export 해두면 설치 시 자동 주입됩니다. ```bash 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)에서 직접 사용 개발자라면 터미널에서 직접 법령·공공기관 규정을 검색할 수 있습니다. ```bash # 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 키 전달 방법 정리 여러 방법으로 인증키를 전달할 수 있습니다. 위에서부터 우선 적용됩니다: | 방법 | 사용법 | 용도 | |------|--------|------| | URL에 포함 | 주소 끝에 `?oc=내키` | 웹 클라이언트에서 가장 간편 | | HTTP 헤더 | `apikey: 내키` | 프로그래밍으로 연동할 때 | | 환경변수 | `LAW_OC=내키` | 로컬 설치(방법 3, 4) | | 도구 파라미터 | `apiKey: "내키"` | 특정 요청만 다른 키 쓸 때 | --- ## 사용 예시 ### 법제처 도구 — 법령·판례·해석례 ``` "민법 제1조 알려줘" → AI 가 법령 검색 → 해당 조문 자동 조회 "음주운전 처벌 기준" → AI 가 관련 법령 + 판례 + 해석례를 자동으로 종합 분석 "근로기준법 제74조 해석례" → AI 가 해당 조문 + 정부 해석례를 자동 매칭 ``` ### ALIO 공공기관 규정 도구 ``` "OO진흥원 인사규정 보여줘" → AI 가 정식 기관명을 자동 매칭 → 해당 기관 규정 목록 표시 "공공기관 휴직 규정 비교해줘" → AI 가 수집된 공공기관 전체에서 휴직 관련 규정을 자동 비교 "우리 기관에 없는 동종 기관 규정" → AI 가 동종 기관 보유 규정 - 자기 기관 보유 규정 = 벤치마킹 후보 자동 추출 ``` ### 법제처와 ALIO 를 연결하는 도구 공공기관 내부규정은 본질적으로 상위 법제처 법령에서 위임/근거를 받습니다. 두 영역을 잇는 자연어 질의도 자동 처리: ``` "OO진흥원 인사규정과 관련된 상위 법령을 알려줘" → AI 가 규정 본문에서 인용된 상위 법령을 자동 추출 + 법제처에서 각 법령 정보를 자동 조회 "OO공단의 OOO지침이 근로기준법을 준수하는지 검토해줘" → AI 가 35,000건 공공기관 규정에서 해당 법령 인용 위치를 역검색 → 매칭된 지침의 인용 컨텍스트 + 기관별 그룹 표시 ``` --- ## 도구 구조 (125개) | 구분 | 개수 | 비고 | |------|------|------| | 법령·행정규칙·자치법규 | 16 | 검색·조회·비교·연계 | | 판례·해석례 | 7 | 대법원·법령해석례 | | 위원회 결정문 | 10 | 헌재·공정위·개인정보위·노동위·권익위 | | 조세심판·관세·조약·영문 | 8 | 도메인별 결정문/원문 | | 학칙·공사공단·공공기관 (법제처) | 6 | 공공·교육 영역 | | 별표·체계·통계·이력·용어사전 등 부가 | 24 | | | 체인 도구 (자동 종합) | 8 | 종합리서치·법체계·처분근거·쟁송·개정추적·조례비교·절차상세·문서검토 | | 문서분석·유틸 | 8 | 조문번호 변환, 약칭 사전 등 | | ALIO 공공기관 규정 | 22 | 검색·조회·비교·벤치마킹·타임라인·통계 + 두 영역 연계 3종 | | ALIO 체인 도구 | 1 | 기관 종합 벤치마킹 | | ALIO 보고서형 공시 | 15 | 단체협약·임금협약·노사협의회 각 5종 (검색·조회·비교) | | **합계** | **125** | | 전체 도구 상세 (이름·파라미터·예시) 는 [`docs/API.md`](./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 --- ## 환경 변수 | 변수 | 필수 | 용도 | |------|------|------| | `LAW_OC` | ✅ | 법제처 OpenAPI 신청자의 오픈 API 인증키 | 전체 변수 + 예시는 [`.env.example`](./.env.example) 참고. --- ## 문서 | 문서 | 설명 | |------|------| | [`README.md`](./README.md) | 한글 README (현재 문서) | | [`README-EN.md`](./README-EN.md) | 영문 README | | [`docs/API.md`](./docs/API.md) | 125개 도구 레퍼런스 | | [`LICENSE`](./LICENSE) | MIT | | [`NOTICE`](./NOTICE) | 사용한 외부 라이브러리·데이터의 출처와 라이선스 표기 | --- ## 감사의 말 본 프로젝트는 다음 분들 덕분에 가능했습니다: - chrisryugj 님 — [korean-law-mcp](https://github.com/chrisryugj/korean-law-mcp), [kordoc](https://github.com/chrisryugj/kordoc) 프로젝트를 만드시지 않았으면 이 프로젝트는 시작될 수 없었습니다. 진심으로 감사드립니다. - jkg 님 — ALIO 공공기관 내부규정을 통합해 보자는 아이디어를 주셔서 감사합니다. --- ## 라이선스 [MIT](./LICENSE) --- _{Made by <a href="https://github.com/scvcoder">scvcoder</a>}