@clazic/kordoc 2.1.2 → 2.1.4

package/README.md

@@ -106,9 +106,6 @@ HWP, HWPX, PDF, XLSX, DOCX — 관공서에서 쏟아지는 모든 문서를 파
 
 ```bash
 npm install @clazic/kordoc
-
-# PDF 파싱이 필요하면 (선택)
-npm install pdfjs-dist
 ```
 
 ## 빠른 시작
@@ -195,28 +192,55 @@ kordoc watch ./수신함 -d ./변환결과              # 폴더 감시 모드
 kordoc watch ./문서 --webhook https://api/hook  # 웹훅 알림
 ```
 
-## MCP 서버 (Claude / Cursor / Windsurf)
+## MCP 서버
+
+AI 도구에서 직접 문서를 파싱할 수 있습니다. **로컬 MCP**와 **원격 MCP** 두 가지 방식을 지원합니다.
+
+| | 로컬 MCP | 원격 MCP |
+|---|---|---|
+| 지원 포맷 | HWP, HWPX, PDF, XLSX, DOCX | HWPX, PDF, XLSX, DOCX |
+| 설치 | `npm install -g @clazic/kordoc` 필요 | 설치 불필요 |
+| 파일 전달 | 파일 경로 직접 | base64 인코딩 |
+
+---
+
+### 로컬 MCP (전 포맷 지원, 권장)
+
+**1. 전역 설치**
+
+```bash
+npm install -g @clazic/kordoc
+```
+
+**2. AI 도구별 설정**
+
+#### Claude Code
 
-### 원격 MCP (설치 불필요 — 파일을 base64로 전송)
+`~/.claude.json` 에 추가:
 
 ```json
 {
   "mcpServers": {
     "kordoc": {
-      "serverUrl": "https://kordoc-mcp.clazic.workers.dev"
+      "type": "stdio",
+      "command": "kordoc-mcp",
+      "args": [],
+      "env": {}
     }
   }
 }
 ```
 
-> HWPX, XLSX, DOCX, PDF 지원. HWP 5.x는 로컬 MCP 사용.
-
-### 로컬 MCP (HWP 5.x 포함 전 포맷, 파일 경로 직접 접근)
+또는 터미널에서:
 
 ```bash
-npm install -g @clazic/kordoc
+claude mcp add kordoc -- kordoc-mcp
 ```
 
+#### Gemini CLI
+
+`~/.gemini/settings.json` 에 추가:
+
 ```json
 {
   "mcpServers": {
@@ -227,6 +251,51 @@ npm install -g @clazic/kordoc
 }
 ```
 
+#### Cursor / Windsurf / VS Code
+
+프로젝트 루트 `.mcp.json` 또는 설정 파일에 추가:
+
+```json
+{
+  "mcpServers": {
+    "kordoc": {
+      "command": "kordoc-mcp"
+    }
+  }
+}
+```
+
+#### Windows
+
+Windows에서는 `cmd`를 통해 실행해야 합니다:
+
+```json
+{
+  "mcpServers": {
+    "kordoc": {
+      "command": "cmd",
+      "args": ["/c", "kordoc-mcp"]
+    }
+  }
+}
+```
+
+---
+
+### 원격 MCP (설치 없이 바로 사용)
+
+HWP 5.x를 제외한 모든 포맷 지원. 설치 없이 바로 연결 가능합니다.
+
+```json
+{
+  "mcpServers": {
+    "kordoc": {
+      "serverUrl": "https://kordoc-mcp.clazic.workers.dev"
+    }
+  }
+}
+```
+
 **7개 도구:**
 
 | 도구 | 설명 |

package/dist/{chunk-R6J5ZSDL.js → chunk-N2UPMKGJ.js}

@@ -6,7 +6,7 @@ import {
   precheckZipSize,
   sanitizeHref,
   toArrayBuffer
-} from "./chunk-PKIJLEV6.js";
+} from "./chunk-NNYD6QUN.js";
 import {
   parsePageRange
 } from "./chunk-MOL7MDBG.js";
@@ -309,7 +309,7 @@ var HEADING_RATIO_H2 = 1.3;
 var HEADING_RATIO_H3 = 1.15;
 
 // src/hwpx/parser.ts
-var MAX_DECOMPRESS_SIZE = 100 * 1024 * 1024;
+var MAX_DECOMPRESS_SIZE = 500 * 1024 * 1024;
 var MAX_ZIP_ENTRIES = 500;
 function clampSpan(val, max) {
   return Math.max(1, Math.min(val, max));
@@ -1135,7 +1135,7 @@ function readRecords(data) {
   }
   return records;
 }
-var MAX_DECOMPRESS_SIZE2 = 100 * 1024 * 1024;
+var MAX_DECOMPRESS_SIZE2 = 500 * 1024 * 1024;
 function decompressStream(data) {
   const opts = { maxOutputLength: MAX_DECOMPRESS_SIZE2 };
   if (data.length >= 2 && data[0] === 120) {
@@ -1969,7 +1969,7 @@ var END_OF_CHAIN = 4294967294;
 var FREE_SECT = 4294967295;
 var MAX_CHAIN_LENGTH = 1e6;
 var MAX_DIR_ENTRIES = 1e5;
-var MAX_STREAM_SIZE = 100 * 1024 * 1024;
+var MAX_STREAM_SIZE = 500 * 1024 * 1024;
 function parseLenientCfb(data) {
   if (data.length < 512) throw new Error("CFB \uD30C\uC77C\uC774 \uB108\uBB34 \uC9E7\uC2B5\uB2C8\uB2E4 (\uCD5C\uC18C 512\uBC14\uC774\uD2B8)");
   if (!data.subarray(0, 8).equals(CFB_MAGIC)) throw new Error("CFB \uB9E4\uC9C1 \uBC14\uC774\uD2B8 \uBD88\uC77C\uCE58");
@@ -2147,7 +2147,7 @@ import { createRequire } from "module";
 var require2 = createRequire(import.meta.url);
 var CFB = require2("cfb");
 var MAX_SECTIONS = 100;
-var MAX_TOTAL_DECOMPRESS = 100 * 1024 * 1024;
+var MAX_TOTAL_DECOMPRESS = 500 * 1024 * 1024;
 function parseHwp5Document(buffer, options) {
   let cfb = null;
   let lenientCfb = null;
@@ -3410,7 +3410,7 @@ g.pdfjsWorker = pdfjsWorker;
 import { getDocument, GlobalWorkerOptions } from "pdfjs-dist/legacy/build/pdf.mjs";
 GlobalWorkerOptions.workerSrc = "";
 var MAX_PAGES = 5e3;
-var MAX_TOTAL_TEXT = 100 * 1024 * 1024;
+var MAX_TOTAL_TEXT = 500 * 1024 * 1024;
 var PDF_LOAD_TIMEOUT_MS = 3e4;
 async function loadPdfWithTimeout(buffer) {
   const loadingTask = getDocument({
@@ -4375,7 +4375,7 @@ import { readFile } from "fs/promises";
 import JSZip3 from "jszip";
 import { DOMParser as DOMParser2 } from "@xmldom/xmldom";
 var MAX_SHEETS = 100;
-var MAX_DECOMPRESS_SIZE3 = 100 * 1024 * 1024;
+var MAX_DECOMPRESS_SIZE3 = 500 * 1024 * 1024;
 var MAX_ROWS2 = 1e4;
 var MAX_COLS2 = 200;
 function cleanNumericValue(raw) {
@@ -4655,7 +4655,7 @@ async function parseXlsxDocument(buffer, options) {
 // src/docx/parser.ts
 import JSZip4 from "jszip";
 import { DOMParser as DOMParser3 } from "@xmldom/xmldom";
-var MAX_DECOMPRESS_SIZE4 = 100 * 1024 * 1024;
+var MAX_DECOMPRESS_SIZE4 = 500 * 1024 * 1024;
 function getChildElements(parent, localName) {
   const result = [];
   const children = parent.childNodes;
@@ -5491,4 +5491,4 @@ export {
   extractFormFields,
   parse
 };
-//# sourceMappingURL=chunk-R6J5ZSDL.js.map
+//# sourceMappingURL=chunk-N2UPMKGJ.js.map