korean-law-mcp 2.2.0 → 2.3.1

package/README.md

@@ -1,47 +1,78 @@
 # Korean Law MCP
 
-**87 tools to search, retrieve, and analyze Korean law** — statutes, precedents, ordinances, treaties, and more.
+**대한민국 법령 검색·조회·분석 89개 도구** — 법령, 판례, 행정규칙, 자치법규, 조약, 해석례를 AI 어시스턴트나 터미널에서 바로 사용.
 
 [![npm version](https://img.shields.io/npm/v/korean-law-mcp.svg)](https://www.npmjs.com/package/korean-law-mcp)
 [![MCP 1.27](https://img.shields.io/badge/MCP-1.27-blue)](https://modelcontextprotocol.io)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
-[![TypeScript](https://img.shields.io/badge/TypeScript-5.9-blue)](https://www.typescriptlang.org/)
 
-> MCP server + CLI for Korea's official legal database (법제처 Open API). Works with Claude Desktop, Cursor, Windsurf, Zed, and any MCP-compatible client.
+> 법제처 Open API 기반 MCP 서버 + CLI. Claude Desktop, Cursor, Windsurf, Zed, Claude.ai 등에서 바로 사용 가능.
 
-[한국어](./README-KR.md)
+[English](./README-EN.md)
+
+![Korean Law MCP 데모](./demo.gif)
 
 ---
 
-## Why this exists
+## v2.3.1 변경사항
+
+- **URL 쿼리 API 키 지원** — 원격 MCP 접속 시 `?oc=your-key`로 API 키를 URL에 포함 가능. 매 요청마다 키를 전달할 필요 없이 세션 전체에 자동 적용. Claude.ai 등 커스텀 헤더 설정이 어려운 웹 클라이언트에서 유용.
+- **체인 도구 자동 전문 조회** — `chain_ordinance_compare`가 자치법규 검색 후 상위 1건 전문을 자동 조회하여 반환. 별도로 `get_ordinance`를 호출할 필요 없음.
+- **lite 프로필 도구 라우팅 개선** — 체인/메타 도구 description을 INPUT 의도 기반으로 재작성. 예시 포함으로 Claude 웹이 자치법규 검색·조회 등 올바른 도구를 선택하도록 개선.
+- **도구 힌트 execute_tool 경로 통일** — 비lite 도구 안내를 `execute_tool()` 호출 예시로 변경. Claude 웹이 존재하지 않는 도구를 직접 호출하는 문제 방지.
+
+<details>
+<summary>v2.3.0 변경사항</summary>
+
+- **도구 프로필 (lite/full)** — 웹 클라이언트(Claude.ai 등)용 lite 프로필 도입. 89개 → 14개로 자동 축소하여 컨텍스트 소비 87% 절감. `/mcp?profile=lite`로 사용.
+  - **체인 8개** + 핵심 직접 도구 4개 + 메타 도구 2개 = 14개로 동일 기능 커버
+  - `discover_tools`: 의도/카테고리로 숨겨진 전문 도구 검색
+  - `execute_tool`: discover로 찾은 도구를 프록시 실행
+- **kordoc 통합 파서** — 자체 HWP5/HWPX/PDF 파서 5개를 [kordoc](https://github.com/chrisryugj/kordoc) 통합 파서로 교체. 의존성 경량화.
+
+</details>
+
+<details>
+<summary>v2.2.0 변경사항</summary>
+
+- **23개 신규 도구 (64 → 87)** — 조약, 법령-자치법규 연계, 학칙/공단/공공기관 규정, 특별행정심판, 감사원 결정, 조항상세, 문서분석, 행정규칙 신구대조 등 대폭 확장.
+- **문서분석 엔진** — 8종 문서유형 분류, 17개 리스크규칙, 금액/기간 추출, 조항 충돌 탐지.
+- **법령-자치법규 연계 (4개 도구)** — 법률↔조례 위임 체인을 양방향 추적.
+- **조약 지원 (2개 도구)** — 대한민국이 체결한 양자/다자 조약 검색 및 전문 조회.
+- **보안 강화** — CORS 오리진 제어, API 키 헤더 전용, 보안 헤더, 세션 ID 마스킹.
+
+</details>
 
-South Korea has **1,600+ active laws**, **10,000+ administrative rules**, and a precedent system spanning Supreme Court, Constitutional Court, tax tribunals, and customs rulings. All of this lives behind a clunky government API with zero developer experience.
+<details>
+<summary>v1.8.0 – v1.9.0 기능</summary>
 
-This project wraps that entire legal system into **87 structured tools** that any AI assistant or script can call. Built by a Korean civil servant who got tired of manually searching [법제처](https://www.law.go.kr) for the hundredth time.
+- **체인 도구 8개** — 복합 리서치를 한 번의 호출로: `chain_full_research`(AI검색→법령→판례→해석), `chain_law_system`, `chain_action_basis`, `chain_dispute_prep`, `chain_amendment_track`, `chain_ordinance_compare`, `chain_procedure_detail`.
+- **일괄 조문 조회** — `get_batch_articles`가 `laws` 배열로 복수 법령 한 번에 조회.
+- **AI 검색 법령종류 필터** — `search_ai_law`에 `lawTypes` 필터 추가.
+- **구조화 에러 포맷** — `[에러코드] + 도구명 + 제안` 형식으로 64개 도구 통일.
+- **HWP 테이블 수정** — 구형 HWP 파서에서 `paragraph.controls[].content` 경로의 테이블 추출 지원.
+
+</details>
 
 ---
 
-## Features
+## 왜 만들었나
+
+대한민국에는 **1,600개 이상의 현행 법률**, **10,000개 이상의 행정규칙**, 그리고 대법원·헌법재판소·조세심판원·관세청까지 이어지는 방대한 판례 체계가 있습니다. 이 모든 게 [법제처](https://www.law.go.kr)라는 하나의 사이트에 있지만, 개발자 경험은 최악입니다.
 
-- **87 Legal Tools** — Statutes, precedents, admin rules, ordinances, constitutional decisions, tax rulings, customs interpretations, treaties, institutional rules, legal terminology
-- **MCP + CLI** — Use from Claude Desktop or from your terminal. Same 87 tools.
-- **Korean Law Intelligence** — Auto-resolves abbreviations (`화관법` → `화학물질관리법`), converts article numbers (`제38조` ↔ `003800`), visualizes 3-tier delegation
-- **Annex Extraction** — Downloads HWPX/HWP annexes and converts tables to Markdown automatically
-- **8 Chain Tools** — Composite research workflows in a single call (e.g. `chain_full_research`: AI search → statutes → precedents → interpretations)
-- **Caching** — 1-hour search cache, 24-hour article cache
-- **Remote Endpoint** — Use without installation via `https://korean-law-mcp.fly.dev/mcp`
+이 프로젝트는 그 전체 법령 시스템을 **89개 구조화된 도구**로 감싸서, AI 어시스턴트나 스크립트에서 바로 호출할 수 있게 만듭니다. 법제처를 백 번째 수동 검색하다 지친 공무원이 만들었습니다.
 
 ---
 
-## Quick Start
+## 빠른 시작
 
-### Option 1: MCP Server (Claude Desktop / Cursor / Windsurf)
+### MCP 서버 (Claude Desktop / Cursor / Windsurf)
 
 ```bash
 npm install -g korean-law-mcp
 ```
 
-Add to your MCP client config:
+MCP 클라이언트 설정에 추가:
 
 ```json
 {
@@ -56,29 +87,49 @@ Add to your MCP client config:
 }
 ```
 
-Get your free API key at [법제처 Open API](https://open.law.go.kr/LSO/openApi/guideResult.do).
+API 키는 [법제처 Open API](https://open.law.go.kr/LSO/openApi/guideResult.do)에서 무료 발급.
 
-| Client | Config File |
-|--------|------------|
+| 클라이언트 | 설정 파일 |
+|-----------|----------|
 | Claude Desktop | `%APPDATA%\Claude\claude_desktop_config.json` (Win) / `~/Library/Application Support/Claude/claude_desktop_config.json` (Mac) |
 | Cursor | `.cursor/mcp.json` |
 | Windsurf | `.windsurf/mcp.json` |
 | Continue | `~/.continue/config.json` |
 | Zed | `~/.config/zed/settings.json` |
 
-### Option 2: Remote (No Install)
+### 원격 MCP (설치 없이 바로)
+
+API 키를 URL에 포함하여 바로 사용:
 
 ```json
 {
   "mcpServers": {
     "korean-law": {
-      "url": "https://korean-law-mcp.fly.dev/mcp"
+      "url": "https://korean-law-mcp.fly.dev/mcp?oc=your-api-key"
     }
   }
 }
 ```
 
-### Option 3: CLI
+**Claude.ai 등 웹 클라이언트** — 컨텍스트 절약을 위해 lite 프로필 권장:
+
+```
+https://korean-law-mcp.fly.dev/mcp?profile=lite&oc=your-api-key
+```
+
+> lite 프로필은 체인 8개 + 핵심 4개 + 메타 2개 = **14개 도구**로 동일 기능 커버. 특수 도구가 필요하면 `discover_tools` → `execute_tool`로 접근.
+
+**API 키 전달 방법** (우선순위순):
+
+| 방법 | 예시 | 설명 |
+|------|------|------|
+| URL 쿼리 | `?oc=your-key` | 웹 클라이언트에서 가장 간편. 세션 전체에 자동 적용 |
+| HTTP 헤더 | `apikey: your-key` | `law-oc`, `x-api-key`, `Authorization: Bearer` 등도 지원 |
+| 도구 파라미터 | `apiKey: "your-key"` | 개별 도구 호출 시 직접 전달 |
+
+> API 키는 [법제처 Open API](https://open.law.go.kr/LSO/openApi/guideResult.do)에서 무료 발급.
+
+### CLI
 
 ```bash
 npm install -g korean-law-mcp
@@ -87,221 +138,77 @@ export LAW_OC=your-api-key
 korean-law search_law --query "관세법"
 korean-law get_law_text --mst 160001 --jo "제38조"
 korean-law search_precedents --query "부당해고"
-korean-law list                          # all 87 tools
-korean-law list --category 판례          # filter by category
-korean-law help search_law               # tool help
-```
-
-### Option 4: Docker
-
-```bash
-docker build -t korean-law-mcp .
-docker run -e LAW_OC=your-api-key -p 3000:3000 korean-law-mcp
+korean-law list                          # 89개 전체 도구 목록
+korean-law list --category 판례          # 카테고리별 필터
+korean-law help search_law               # 도구 도움말
 ```
 
 ---
 
-## Tool Categories (87 total)
-
-### Search (11)
-
-| Tool | Description |
-|------|-------------|
-| `search_law` | Search statutes (auto-resolves abbreviations) |
-| `search_admin_rule` | Search administrative rules |
-| `search_ordinance` | Search local ordinances |
-| `search_precedents` | Search court precedents |
-| `search_interpretations` | Search legal interpretations |
-| `search_all` | Unified search across all categories |
-| `suggest_law_names` | Law name autocomplete |
-| `advanced_search` | Advanced search with date/keyword filters |
-| `get_law_history` | Law amendment history by date |
-| `get_annexes` | Retrieve annexes + extract HWPX/HWP to Markdown |
-| `parse_jo_code` | Article number ↔ JO code conversion |
-
-### Retrieve (9)
-
-| Tool | Description |
-|------|-------------|
-| `get_law_text` | Full statute text |
-| `get_admin_rule` | Full administrative rule |
-| `get_ordinance` | Full local ordinance |
-| `get_precedent_text` | Full precedent text |
-| `get_interpretation_text` | Full interpretation text |
-| `get_batch_articles` | Batch article retrieval (multiple laws) |
-| `get_article_with_precedents` | Article + related precedents |
-| `compare_old_new` | Old vs. new law comparison |
-| `get_three_tier` | Law → Decree → Rule 3-tier comparison |
-
-### Analyze (10)
-
-| Tool | Description |
-|------|-------------|
-| `compare_articles` | Cross-law article comparison |
-| `get_law_tree` | Delegation structure tree |
-| `get_article_history` | Article amendment history |
-| `summarize_precedent` | Precedent summary |
-| `extract_precedent_keywords` | Precedent keyword extraction |
-| `find_similar_precedents` | Similar precedent search |
-| `get_law_statistics` | Law statistics |
-| `parse_article_links` | Parse in-text legal references |
-| `get_external_links` | Generate external links |
-| `analyze_document` | Document analysis with legal context |
-
-### Specialized: Tax & Customs (4)
-
-| Tool | Description |
-|------|-------------|
-| `search_tax_tribunal_decisions` | Tax tribunal decision search |
-| `get_tax_tribunal_decision_text` | Tax tribunal decision full text |
-| `search_customs_interpretations` | Customs interpretation search |
-| `get_customs_interpretation_text` | Customs interpretation full text |
-
-### Specialized: Constitutional & Admin Appeals (4)
-
-| Tool | Description |
-|------|-------------|
-| `search_constitutional_decisions` | Constitutional Court decision search |
-| `get_constitutional_decision_text` | Constitutional Court decision full text |
-| `search_admin_appeals` | Administrative appeal decision search |
-| `get_admin_appeal_text` | Administrative appeal decision full text |
-
-### Specialized: Committee Decisions (8)
-
-| Tool | Description |
-|------|-------------|
-| `search_ftc_decisions` | Fair Trade Commission decision search |
-| `get_ftc_decision_text` | Fair Trade Commission decision full text |
-| `search_pipc_decisions` | Privacy Commission decision search |
-| `get_pipc_decision_text` | Privacy Commission decision full text |
-| `search_nlrc_decisions` | Labor Relations Commission decision search |
-| `get_nlrc_decision_text` | Labor Relations Commission decision full text |
-| `search_acr_decisions` | Board of Audit & Inspection decision search |
-| `get_acr_decision_text` | Board of Audit & Inspection decision full text |
-
-### Specialized: Special Admin Appeals (4) `NEW`
-
-| Tool | Description |
-|------|-------------|
-| `search_acr_special_appeals` | Special administrative appeal search |
-| `get_acr_special_appeal_text` | Special administrative appeal full text |
-| `search_appeal_review_decisions` | Appeal review decision search |
-| `get_appeal_review_decision_text` | Appeal review decision full text |
-
-### Law-Ordinance Linkage (4) `NEW`
-
-| Tool | Description |
-|------|-------------|
-| `get_linked_ordinances` | Find ordinances linked to a law |
-| `get_linked_ordinance_articles` | Get linked ordinance article details |
-| `get_delegated_laws` | Find laws delegating to ordinances |
-| `get_linked_laws_from_ordinance` | Find parent laws from an ordinance |
-
-### Treaties (2) `NEW`
-
-| Tool | Description |
-|------|-------------|
-| `search_treaties` | Treaty search |
-| `get_treaty_text` | Treaty full text |
-
-### Institutional Rules (6) `NEW`
-
-| Tool | Description |
-|------|-------------|
-| `search_school_rules` | School rule search |
-| `get_school_rule_text` | School rule full text |
-| `search_public_corp_rules` | Public corporation rule search |
-| `get_public_corp_rule_text` | Public corporation rule full text |
-| `search_public_institution_rules` | Public institution rule search |
-| `get_public_institution_rule_text` | Public institution rule full text |
-
-### Knowledge Base (7)
-
-| Tool | Description |
-|------|-------------|
-| `get_legal_term_kb` | Legal terminology search |
-| `get_legal_term_detail` | Term definition |
-| `get_daily_term` | Everyday language search |
-| `get_daily_to_legal` | Everyday → legal term mapping |
-| `get_legal_to_daily` | Legal → everyday term mapping |
-| `get_term_articles` | Articles using a term |
-| `get_related_laws` | Related laws |
-
-### Chain Tools (8)
-
-Composite research workflows — multiple tools in a single call.
-
-| Tool | Workflow |
-|------|----------|
-| `chain_law_system` | Search → 3-tier comparison → batch articles |
-| `chain_action_basis` | Law system → interpretations → precedents → appeals |
-| `chain_dispute_prep` | Precedents + appeals + specialized decisions |
-| `chain_amendment_track` | Old/new comparison + article history |
-| `chain_ordinance_compare` | Parent law → nationwide ordinance search |
-| `chain_full_research` | AI search → statutes → precedents → interpretations |
-| `chain_procedure_detail` | Law system → annexes → enforcement rule annexes |
-| `chain_document_review` | Document analysis → related laws → precedents |
-
-### Other (10)
-
-| Tool | Description |
-|------|-------------|
-| `search_ai_law` | Natural language AI search |
-| `search_english_law` | English law search |
-| `get_english_law_text` | English law full text |
-| `search_historical_law` | Historical law search |
-| `get_historical_law` | Historical law full text |
-| `search_legal_terms` | Legal dictionary search |
-| `get_law_system_tree` | Law system tree visualization |
-| `get_law_abbreviations` | Law abbreviation list |
-| `get_article_detail` | Single article detail retrieval |
-| `compare_admin_rule_old_new` | Admin rule old vs. new comparison |
-
----
-
-## Usage Examples
+## 사용 예시
 
 ```
-User: "관세법 제38조 알려줘"
-→ search_law("관세법") → get_law_text(mst, jo="003800")
+"관세법 제38조 알려줘"
+→ search_law("관세법") → MST 획득 → get_law_text(mst, jo="003800")
 
-User: "화관법 최근 개정 비교"
-→ "화관법" → "화학물질관리법" auto-resolved → compare_old_new(mst)
+"화관법 최근 개정 비교"
+→ "화관법" → "화학물질관리법" 자동 변환 → compare_old_new(mst)
 
-User: "근로기준법 제74조 해석례"
+"근로기준법 제74조 해석례"
 → search_interpretations("근로기준법 제74조") → get_interpretation_text(id)
 
-User: "산업안전보건법 별표1 내용"
-→ get_annexes("산업안전보건법 별표1") → HWPX download → Markdown table
+"산업안전보건법 별표1 내용 알려줘"
+→ get_annexes(lawName="산업안전보건법 별표1") → HWPX 파일 다운로드 → 표/텍스트 Markdown 변환
 ```
 
 ---
 
-## Environment Variables
+## 도구 목록 (89개)
+
+| 카테고리 | 개수 | 주요 도구 |
+|----------|------|----------|
+| **검색** | 11 | `search_law`, `search_precedents`, `search_all`, `get_annexes` |
+| **조회** | 9 | `get_law_text`, `get_batch_articles`, `compare_old_new`, `get_three_tier` |
+| **분석** | 10 | `compare_articles`, `get_law_tree`, `summarize_precedent`, `analyze_document` |
+| **전문: 조세/관세** | 4 | `search_tax_tribunal_decisions`, `search_customs_interpretations` |
+| **전문: 헌재/행심** | 4 | `search_constitutional_decisions`, `search_admin_appeals` |
+| **전문: 위원회 결정** | 8 | 공정위, 개보위, 노동위, 감사원 |
+| **특별행정심판** | 4 | `search_acr_special_appeals`, `search_appeal_review_decisions` |
+| **법령-자치법규 연계** | 4 | `get_linked_ordinances`, `get_delegated_laws` |
+| **조약** | 2 | `search_treaties`, `get_treaty_text` |
+| **학칙/공단/공공기관** | 6 | `search_school_rules`, `search_public_corp_rules`, `search_public_institution_rules` |
+| **지식베이스** | 7 | `get_legal_term_kb`, `get_daily_to_legal`, `get_related_laws` |
+| **체인** | 8 | `chain_full_research`, `chain_law_system`, `chain_document_review` |
+| **메타** | 2 | `discover_tools`, `execute_tool` (lite 프로필용) |
+| **기타** | 10 | AI 검색, 영문법령, 연혁법령, 법령용어, 약칭, 법체계도, 행정규칙비교 |
+
+전체 도구 상세는 [영문 README](./README-EN.md#tool-categories-89-total) 참조.
 
-| Variable | Required | Default | Description |
-|----------|----------|---------|-------------|
-| `LAW_OC` | Yes | — | 법제처 API key ([get one free](https://open.law.go.kr/LSO/openApi/guideResult.do)) |
-| `PORT` | No | 3000 | HTTP server port |
-| `CORS_ORIGIN` | No | `*` | CORS allowed origin |
-| `RATE_LIMIT_RPM` | No | 60 | Requests per minute per IP |
+---
+
+## 주요 특징
 
-## Documentation
+- **89개 법률 도구** — 법령, 판례, 행정규칙, 자치법규, 헌재결정, 조세심판, 관세해석, 조약, 학칙/공단/공공기관 규정, 법령용어
+- **MCP + CLI** — Claude Desktop에서도, 터미널에서도 같은 89개 도구 사용
+- **법률 도메인 특화** — 약칭 자동 인식(`화관법` → `화학물질관리법`), 조문번호 변환(`제38조` ↔ `003800`), 3단 위임 구조 시각화
+- **별표/별지서식 본문 추출** — HWPX·HWP 파일 자동 다운로드 → 표/텍스트를 Markdown 변환
+- **8개 체인 도구** — 복합 리서치를 한 번의 호출로 (예: `chain_full_research`: AI검색→법령→판례→해석)
+- **도구 프로필** — 웹 클라이언트용 lite(14개), 파워유저용 full(89개) 자동 선택
+- **캐시** — 검색 1시간, 조문 24시간 TTL
+- **원격 엔드포인트** — 설치 없이 `https://korean-law-mcp.fly.dev/mcp`로 바로 사용
 
-- [docs/API.md](docs/API.md) — 87-tool reference
-- [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md) — System design
-- [docs/DEVELOPMENT.md](docs/DEVELOPMENT.md) — Development guide
+---
 
-## Credits
+## 문서
 
-- [법제처](https://www.law.go.kr) Open API — Korea's official legal database
-- [Anthropic](https://anthropic.com) — Model Context Protocol
-- [kordoc](https://github.com/chrisryugj/kordoc) — HWP/HWPX parser (same author)
+- [docs/API.md](docs/API.md) — 89개 도구 레퍼런스 (프로필 포함)
+- [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md) — 시스템 설계
+- [docs/DEVELOPMENT.md](docs/DEVELOPMENT.md) — 개발 가이드
 
-## License
+## 라이선스
 
 [MIT](./LICENSE)
 
 ---
 
-<sub>Made by a Korean civil servant @ 광진구청 AI동호회 AI.Do</sub>
+<sub>Made by 류주임 @ 광진구청 AI동호회 AI.Do</sub>

package/build/index.js

@@ -13,9 +13,9 @@ import { VERSION } from "./version.js";
 const LAW_OC = process.env.LAW_OC || "";
 const apiClient = new LawApiClient({ apiKey: LAW_OC });
 // MCP 서버 팩토리 (HTTP 모드: 세션마다 새 인스턴스 필요)
-function createServer() {
+function createServer(profile) {
     const s = new Server({ name: "korean-law", version: VERSION }, { capabilities: { tools: {} } });
-    registerTools(s, apiClient);
+    registerTools(s, apiClient, profile ?? "full");
     return s;
 }
 // 서버 시작

package/build/lib/annex-file-parser.d.ts

@@ -1,11 +1,11 @@
 /**
- * 별표 파일 파서 (HWPX / HWP / PDF 분기)
+ * 별표 파일 파서 — kordoc 위임
  *
- * - HWPX (신형): hwpx-parser.ts (manifest 멀티섹션, colSpan/rowSpan, 중첩 테이블)
- * - HWP (구형): hwp5-parser.ts (OLE2 직접 파싱, UTF-16LE 텍스트, 레코드 기반 테이블)
- * - PDF: pdf-parser.ts (pdfjs-dist 서버사이드 텍스트 추출)
+ * HWPX/HWP5/PDF 모두 kordoc 통합 파서에 위임.
+ * kordoc은 colAddr/rowAddr 기반 HWP5 셀 배치, PDF 라인+클러스터 이중 테이블 감지,
+ * ZIP bomb 방지, 깨진 ZIP 복구 등 강화된 파싱 기능을 제공.
  *
- * 참고: https://github.com/roboco-io/hwp2md
+ * @see https://github.com/chrisryugj/kordoc
  */
 export interface AnnexParseResult {
     success: boolean;

package/build/lib/annex-file-parser.js

@@ -1,90 +1,28 @@
 /**
- * 별표 파일 파서 (HWPX / HWP / PDF 분기)
+ * 별표 파일 파서 — kordoc 위임
  *
- * - HWPX (신형): hwpx-parser.ts (manifest 멀티섹션, colSpan/rowSpan, 중첩 테이블)
- * - HWP (구형): hwp5-parser.ts (OLE2 직접 파싱, UTF-16LE 텍스트, 레코드 기반 테이블)
- * - PDF: pdf-parser.ts (pdfjs-dist 서버사이드 텍스트 추출)
+ * HWPX/HWP5/PDF 모두 kordoc 통합 파서에 위임.
+ * kordoc은 colAddr/rowAddr 기반 HWP5 셀 배치, PDF 라인+클러스터 이중 테이블 감지,
+ * ZIP bomb 방지, 깨진 ZIP 복구 등 강화된 파싱 기능을 제공.
  *
- * 참고: https://github.com/roboco-io/hwp2md
+ * @see https://github.com/chrisryugj/kordoc
  */
-import { parseHwpxDocument } from "./hwpx-parser.js";
-import { parseHwp5Document } from "./hwp5-parser.js";
-// ─── 매직바이트 감지 ─────────────────────────────────
-function isHwpxFile(buffer) {
-    const bytes = new Uint8Array(buffer.slice(0, 4));
-    return bytes[0] === 0x50 && bytes[1] === 0x4b && bytes[2] === 0x03 && bytes[3] === 0x04;
-}
-function isOldHwpFile(buffer) {
-    const bytes = new Uint8Array(buffer.slice(0, 4));
-    return bytes[0] === 0xd0 && bytes[1] === 0xcf && bytes[2] === 0x11 && bytes[3] === 0xe0;
-}
-function isPdfFile(buffer) {
-    const bytes = new Uint8Array(buffer.slice(0, 4));
-    return bytes[0] === 0x25 && bytes[1] === 0x50 && bytes[2] === 0x44 && bytes[3] === 0x46;
-}
+import { parse } from "kordoc";
 // ─── 메인 엔트리 ─────────────────────────────────────
 export async function parseAnnexFile(buffer) {
-    if (isHwpxFile(buffer)) {
-        return parseHwpx(buffer);
-    }
-    if (isOldHwpFile(buffer)) {
-        return parseHwp(buffer);
-    }
-    if (isPdfFile(buffer)) {
-        return parsePdf(buffer);
-    }
-    return { success: false, fileType: "unknown", error: "지원하지 않는 파일 형식입니다." };
-}
-// ─── HWPX 파서 (hwpx-parser.ts 위임) ────────────────
-async function parseHwpx(buffer) {
-    try {
-        const markdown = await parseHwpxDocument(buffer);
-        return { success: true, fileType: "hwpx", markdown };
-    }
-    catch (err) {
-        return { success: false, fileType: "hwpx", error: err instanceof Error ? err.message : "HWPX 파싱 실패" };
-    }
-}
-// ─── 구형 HWP 파서 (hwp5-parser.ts 위임) ────────────
-async function parseHwp(buffer) {
-    try {
-        const markdown = parseHwp5Document(Buffer.from(buffer));
-        return { success: true, fileType: "hwp", markdown };
-    }
-    catch (err) {
-        return { success: false, fileType: "hwp", error: err instanceof Error ? err.message : "HWP 파싱 실패" };
-    }
-}
-// ─── PDF 파서 (pdf-parser.ts 위임) ──────────────────
-async function parsePdf(buffer) {
-    try {
-        const { parsePdfDocument } = await import("./pdf-parser.js");
-        const result = await parsePdfDocument(buffer);
-        if (result.isImageBased) {
-            return {
-                success: false,
-                fileType: "pdf",
-                isImageBased: true,
-                pageCount: result.pageCount,
-                error: result.error,
-            };
-        }
-        if (!result.success || !result.markdown) {
-            return {
-                success: false,
-                fileType: "pdf",
-                pageCount: result.pageCount,
-                error: result.error || "PDF 텍스트 추출 실패",
-            };
-        }
+    const result = await parse(buffer);
+    if (result.success) {
         return {
             success: true,
-            fileType: "pdf",
+            fileType: result.fileType,
             markdown: result.markdown,
-            pageCount: result.pageCount,
         };
     }
-    catch (err) {
-        return { success: false, fileType: "pdf", error: err instanceof Error ? err.message : "PDF 파싱 실패" };
-    }
+    return {
+        success: false,
+        fileType: result.fileType,
+        isImageBased: result.isImageBased,
+        pageCount: result.pageCount,
+        error: result.error,
+    };
 }

package/build/lib/tool-profiles.d.ts

@@ -0,0 +1,14 @@
+/**
+ * 도구 프로필 — 클라이언트별 도구 노출 제어
+ *
+ * lite:  체인 중심 14개 (Claude 웹 등 컨텍스트 제한 클라이언트용)
+ * full:  87개 전체 (Claude Code, STDIO 등 파워 클라이언트용)
+ */
+import type { McpTool } from "./types.js";
+export type ToolProfile = "lite" | "full";
+/** 도구 카테고리 매핑 (discover_tools용) */
+export declare const TOOL_CATEGORIES: Record<string, string[]>;
+/** 프로필 파싱 (잘못된 값이면 full) */
+export declare function parseProfile(value: string | undefined): ToolProfile;
+/** 프로필에 맞는 도구 필터링 */
+export declare function filterToolsByProfile(tools: McpTool[], profile: ToolProfile): McpTool[];

package/build/lib/tool-profiles.js

@@ -0,0 +1,76 @@
+/**
+ * 도구 프로필 — 클라이언트별 도구 노출 제어
+ *
+ * lite:  체인 중심 14개 (Claude 웹 등 컨텍스트 제한 클라이언트용)
+ * full:  87개 전체 (Claude Code, STDIO 등 파워 클라이언트용)
+ */
+/**
+ * lite 프로필에 노출할 도구 목록
+ * - 체인 8개: 내부에서 하위 도구를 직접 호출하므로 기능 손실 없음
+ * - 핵심 직접 도구 4개: 체인으로 커버 안 되는 단순 조회용
+ * - 메타 도구 2개: discover_tools + execute_tool (특수 도구 접근용)
+ */
+const LITE_TOOLS = new Set([
+    // 체인 도구 — 80%+ 유스케이스 커버
+    "chain_full_research",
+    "chain_law_system",
+    "chain_action_basis",
+    "chain_dispute_prep",
+    "chain_amendment_track",
+    "chain_ordinance_compare",
+    "chain_procedure_detail",
+    "chain_document_review",
+    // 핵심 직접 도구 — 단순 조회
+    "search_law",
+    "get_law_text",
+    "search_precedents",
+    "get_precedent_text",
+    // 메타 도구 — 나머지 73개 접근용
+    "discover_tools",
+    "execute_tool",
+]);
+/** 도구 카테고리 매핑 (discover_tools용) */
+export const TOOL_CATEGORIES = {
+    "법령검색": ["search_law", "search_all", "advanced_search", "suggest_law_names", "search_ai_law"],
+    "법령조회": ["get_law_text", "get_article_detail", "get_batch_articles", "get_article_with_precedents"],
+    "행정규칙": ["search_admin_rule", "get_admin_rule", "compare_admin_rule_old_new"],
+    "자치법규": ["search_ordinance", "get_ordinance"],
+    "법령연계": ["get_linked_ordinances", "get_linked_ordinance_articles", "get_delegated_laws", "get_linked_laws_from_ordinance"],
+    "비교분석": ["compare_old_new", "get_three_tier", "compare_articles"],
+    "별표서식": ["get_annexes"],
+    "법체계": ["get_law_tree", "get_law_system_tree"],
+    "통계링크": ["get_law_statistics", "get_external_links", "parse_article_links"],
+    "이력": ["get_article_history", "get_law_history", "get_historical_law", "search_historical_law"],
+    "판례": ["search_precedents", "get_precedent_text", "summarize_precedent", "extract_precedent_keywords", "find_similar_precedents"],
+    "해석례": ["search_interpretations", "get_interpretation_text"],
+    "조세심판": ["search_tax_tribunal_decisions", "get_tax_tribunal_decision_text"],
+    "관세": ["search_customs_interpretations", "get_customs_interpretation_text"],
+    "헌재": ["search_constitutional_decisions", "get_constitutional_decision_text"],
+    "행정심판": ["search_admin_appeals", "get_admin_appeal_text"],
+    "공정위": ["search_ftc_decisions", "get_ftc_decision_text"],
+    "개인정보위": ["search_pipc_decisions", "get_pipc_decision_text"],
+    "노동위": ["search_nlrc_decisions", "get_nlrc_decision_text"],
+    "권익위": ["search_acr_decisions", "get_acr_decision_text"],
+    "소청심사": ["search_appeal_review_decisions", "get_appeal_review_decision_text"],
+    "권익위심판": ["search_acr_special_appeals", "get_acr_special_appeal_text"],
+    "학칙": ["search_school_rules", "get_school_rule_text"],
+    "공사공단": ["search_public_corp_rules", "get_public_corp_rule_text"],
+    "공공기관": ["search_public_institution_rules", "get_public_institution_rule_text"],
+    "조약": ["search_treaties", "get_treaty_text"],
+    "영문법령": ["search_english_law", "get_english_law_text"],
+    "용어": ["search_legal_terms", "get_legal_term_kb", "get_legal_term_detail", "get_daily_term", "get_daily_to_legal", "get_legal_to_daily", "get_term_articles", "get_related_laws"],
+    "문서분석": ["analyze_document"],
+    "유틸리티": ["parse_jo_code", "get_law_abbreviations"],
+};
+/** 프로필 파싱 (잘못된 값이면 full) */
+export function parseProfile(value) {
+    if (value === "lite")
+        return "lite";
+    return "full";
+}
+/** 프로필에 맞는 도구 필터링 */
+export function filterToolsByProfile(tools, profile) {
+    if (profile === "full")
+        return tools;
+    return tools.filter(t => LITE_TOOLS.has(t.name));
+}