korean-law-alio-mcp: Instructions file for Claude Code

CLAUDE.md

이 문서는 본 fork (korean-law-alio-mcp, 2026-04-25 fork by scvcoder) 의 현재 코드 가이드입니다. AI 코딩 어시스턴트(Claude Code 등)와 외부 기여자를 위한 개발 가이드.

• 사용자용 설치/실행 안내는 README.md, 도구 레퍼런스는 docs/API.md
• 본 fork 의 변경 동기와 향후 계획은 ROADMAP.md, 변경 이력은 CHANGELOG.md
• 원작자(@chrisryugj/@Mongmini)의 v2.2 시점 원문 가이드는 CLAUDE-UPSTREAM.md 에 그대로 보존되어 있습니다.

Korean Law + ALIO MCP Server — 법제처 OpenAPI(법령·판례·행정규칙·자치법규·해석례 등) 87개 도구 + ALIO 공공기관 내부규정 23개 + ALIO 보고서형 공시(단체협약·임금협약·노사협의회 각 5개) 15개 = 총 125개 MCP 도구 + 자연어 CLI.

Structure

src/
├── index.ts              # 엔트리포인트 (STDIO/HTTP 모드 선택)
├── cli.ts                # CLI v2 — 자연어 라우팅 + REPL
├── tool-registry.ts      # 모든 도구(법제처 87 + ALIO 38) 정의/등록
├── tools/                # 도구 구현 (각 ~200줄 목표)
│   ├── alio/             # ALIO 공공기관 내부규정 도구 (23개)
│   └── alio-report/      # ALIO 보고서형 공시 도구 팩토리 — 단체협약/임금협약/노사협의회 (각 5개)
├── scripts/
│   └── alio-sync.ts      # ALIO 일괄 수집 배치 (npm run alio:sync)
├── lib/                  # 공통 유틸/파서/클라이언트
│   └── alio/             # ALIO 도메인 모듈 (client/manifest/index-loader/config 등)
└── server/               # HTTP/SSE 서버

자세한 모듈 책임은 아래 Key Files 참고.

Commands

npm install           # 의존성 설치
npm run build         # TypeScript 빌드
npm run watch         # 개발 모드 (tsc --watch)
LAW_OC=키 node build/index.js  # MCP 서버 실행 (STDIO 모드)

# ALIO 공공기관 내부규정 일괄 수집 (배치)
npm run alio:sync                              # ALIO 공시 전체 기관 (default: 내부규정 21110)
npm run alio:sync -- --only C0xxx              # 단일 기관 (apbaId 지정)
npm run alio:sync -- --only C0xxx --limit 10   # smoke test
npm run alio:sync -- --resume                  # 실패 기관만 재시도
npm run alio:sync -- --retry-failed            # parseError 가 남은 규정만 재시도
npm run alio:sync -- --retry-fallback          # 기존 fallback 결과를 새 엔진으로 재생성
npm run alio:sync -- --docling-fallback        # 스캔 이미지 PDF 를 docling OCR 로 복구
npm run alio:sync -- --concurrency 3 --keep-raw

# 보고서형 공시 카테고리 (reportGbn=Y) — 단체협약/임금협약/노사협의회
npm run alio:sync -- --category labor-agreements                    # 단체협약 (21026, v1.1.0)
npm run alio:sync -- --category wage-agreements                     # 임금협약 (21027, v1.2.0)
npm run alio:sync -- --category labor-council                       # 노사협의회 의결사항 (21028, v1.3.0)
npm run alio:sync -- --category wage-agreements --only C0187        # 단일 기관