kordoc 1.7.2 → 1.8.0

package/dist/mcp.js

@@ -1,7 +1,5 @@
 #!/usr/bin/env node
 import {
-  KordocError,
-  VERSION,
   blocksToMarkdown,
   compare,
   detectFormat,
@@ -9,10 +7,15 @@ import {
   extractHwp5MetadataOnly,
   extractHwpxMetadataOnly,
   extractPdfMetadataOnly,
-  parse,
+  parse
+} from "./chunk-QQ6PZADA.js";
+import {
+  KordocError,
+  VERSION,
   sanitizeError,
   toArrayBuffer
-} from "./chunk-NJ3R7LNR.js";
+} from "./chunk-UUKFY5P5.js";
+import "./chunk-MOL7MDBG.js";
 
 // src/mcp.ts
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
@@ -20,7 +23,7 @@ import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js"
 import { z } from "zod";
 import { readFileSync, realpathSync, openSync, readSync, closeSync, statSync } from "fs";
 import { resolve, isAbsolute, extname } from "path";
-var ALLOWED_EXTENSIONS = /* @__PURE__ */ new Set([".hwp", ".hwpx", ".pdf"]);
+var ALLOWED_EXTENSIONS = /* @__PURE__ */ new Set([".hwp", ".hwpx", ".pdf", ".xlsx", ".docx"]);
 var MAX_FILE_SIZE = 500 * 1024 * 1024;
 function safePath(filePath) {
   if (!filePath) throw new KordocError("\uD30C\uC77C \uACBD\uB85C\uAC00 \uBE44\uC5B4\uC788\uC2B5\uB2C8\uB2E4");
@@ -57,9 +60,9 @@ var server = new McpServer({
 });
 server.tool(
   "parse_document",
-  "\uD55C\uAD6D \uBB38\uC11C \uD30C\uC77C(HWP, HWPX, PDF)\uC744 \uB9C8\uD06C\uB2E4\uC6B4\uC73C\uB85C \uBCC0\uD658\uD569\uB2C8\uB2E4. \uD30C\uC77C \uACBD\uB85C\uB97C \uC785\uB825\uD558\uBA74 \uD3EC\uB9F7\uC744 \uC790\uB3D9 \uAC10\uC9C0\uD558\uC5EC \uD14D\uC2A4\uD2B8\uB97C \uCD94\uCD9C\uD569\uB2C8\uB2E4.",
+  "\uD55C\uAD6D \uBB38\uC11C \uD30C\uC77C(HWP, HWPX, PDF, XLSX, DOCX)\uC744 \uB9C8\uD06C\uB2E4\uC6B4\uC73C\uB85C \uBCC0\uD658\uD569\uB2C8\uB2E4. \uD30C\uC77C \uACBD\uB85C\uB97C \uC785\uB825\uD558\uBA74 \uD3EC\uB9F7\uC744 \uC790\uB3D9 \uAC10\uC9C0\uD558\uC5EC \uD14D\uC2A4\uD2B8\uB97C \uCD94\uCD9C\uD569\uB2C8\uB2E4.",
   {
-    file_path: z.string().min(1).describe("\uD30C\uC2F1\uD560 \uBB38\uC11C \uD30C\uC77C\uC758 \uC808\uB300 \uACBD\uB85C (HWP, HWPX, PDF)")
+    file_path: z.string().min(1).describe("\uD30C\uC2F1\uD560 \uBB38\uC11C \uD30C\uC77C\uC758 \uC808\uB300 \uACBD\uB85C (HWP, HWPX, PDF, XLSX, DOCX)")
   },
   async ({ file_path }) => {
     try {

package/dist/mcp.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/mcp.ts"],"sourcesContent":["/** kordoc MCP 서버 — Claude/Cursor에서 문서 파싱 도구로 사용 */\n\nimport { McpServer } from \"@modelcontextprotocol/sdk/server/mcp.js\"\nimport { StdioServerTransport } from \"@modelcontextprotocol/sdk/server/stdio.js\"\nimport { z } from \"zod\"\nimport { readFileSync, realpathSync, openSync, readSync, closeSync, statSync } from \"fs\"\nimport { resolve, isAbsolute, extname } from \"path\"\nimport { parse, detectFormat, blocksToMarkdown, compare, extractFormFields } from \"./index.js\"\nimport { VERSION, toArrayBuffer, sanitizeError, KordocError } from \"./utils.js\"\nimport { extractHwp5MetadataOnly } from \"./hwp5/parser.js\"\nimport { extractHwpxMetadataOnly } from \"./hwpx/parser.js\"\nimport { extractPdfMetadataOnly } from \"./pdf/parser.js\"\n\n/** 허용 파일 확장자 */\nconst ALLOWED_EXTENSIONS = new Set([\".hwp\", \".hwpx\", \".pdf\"])\n/** 최대 파일 크기 (500MB) */\nconst MAX_FILE_SIZE = 500 * 1024 * 1024\n\n/** 경로 정규화 및 보안 검증 */\nfunction safePath(filePath: string): string {\n  if (!filePath) throw new KordocError(\"파일 경로가 비어있습니다\")\n  const resolved = resolve(filePath)\n  const real = realpathSync(resolved)\n  if (!isAbsolute(real)) throw new KordocError(\"절대 경로만 허용됩니다\")\n  const ext = extname(real).toLowerCase()\n  if (!ALLOWED_EXTENSIONS.has(ext)) throw new KordocError(`지원하지 않는 확장자입니다: ${ext} (허용: ${[...ALLOWED_EXTENSIONS].join(\", \")})`)\n  return real\n}\n\n/** 최대 파일 크기 — metadata 전용 (50MB, 전체 파싱보다 보수적) */\nconst MAX_METADATA_FILE_SIZE = 50 * 1024 * 1024\n\n/** 파일 읽기 + 크기 검증 공통 로직 */\nfunction readValidatedFile(filePath: string, maxSize = MAX_FILE_SIZE): { buffer: ArrayBuffer; resolved: string } {\n  const resolved = safePath(filePath)\n  const fileSize = statSync(resolved).size\n  if (fileSize > maxSize) {\n    throw new KordocError(`파일이 너무 큽니다: ${(fileSize / 1024 / 1024).toFixed(1)}MB (최대 ${maxSize / 1024 / 1024}MB)`)\n  }\n  const raw = readFileSync(resolved)\n  return { buffer: toArrayBuffer(raw), resolved }\n}\n\n/** 파일 헤더(16바이트)만 읽어 포맷 감지 — 전체 파일 로드 불필요 */\nfunction detectFormatFromHeader(resolved: string): ReturnType<typeof detectFormat> {\n  const fd = openSync(resolved, \"r\")\n  try {\n    const headerBuf = Buffer.alloc(16)\n    readSync(fd, headerBuf, 0, 16, 0)\n    return detectFormat(toArrayBuffer(headerBuf))\n  } finally {\n    closeSync(fd)\n  }\n}\n\nconst server = new McpServer({\n  name: \"kordoc\",\n  version: VERSION,\n})\n\n// ─── 도구: parse_document ────────────────────────────\n\nserver.tool(\n  \"parse_document\",\n  \"한국 문서 파일(HWP, HWPX, PDF)을 마크다운으로 변환합니다. 파일 경로를 입력하면 포맷을 자동 감지하여 텍스트를 추출합니다.\",\n  {\n    file_path: z.string().min(1).describe(\"파싱할 문서 파일의 절대 경로 (HWP, HWPX, PDF)\"),\n  },\n  async ({ file_path }) => {\n    try {\n      const { buffer } = readValidatedFile(file_path)\n      const format = detectFormat(buffer)\n\n      if (format === \"unknown\") {\n        return {\n          content: [{ type: \"text\", text: `지원하지 않는 파일 형식입니다: ${file_path}` }],\n          isError: true,\n        }\n      }\n\n      const result = await parse(buffer)\n\n      if (!result.success) {\n        return {\n          content: [{ type: \"text\", text: `파싱 실패 (${result.fileType}): ${result.error}` }],\n          isError: true,\n        }\n      }\n\n      const meta = [\n        `포맷: ${result.fileType.toUpperCase()}`,\n        result.pageCount ? `페이지: ${result.pageCount}` : null,\n        result.metadata?.title ? `제목: ${result.metadata.title}` : null,\n        result.metadata?.author ? `작성자: ${result.metadata.author}` : null,\n        result.isImageBased ? \"이미지 기반 PDF (텍스트 추출 불가)\" : null,\n      ].filter(Boolean).join(\" | \")\n\n      // outline/warnings 부가 정보 추가\n      const parts: string[] = [`[${meta}]`]\n\n      if (result.outline && result.outline.length > 0) {\n        const outlineText = result.outline.map(o => `${\"  \".repeat(o.level - 1)}- ${o.text}`).join(\"\\n\")\n        parts.push(`\\n📑 문서 구조:\\n${outlineText}`)\n      }\n\n      if (result.warnings && result.warnings.length > 0) {\n        const warnText = result.warnings.map(w => `- [p${w.page || \"?\"}] ${w.message}`).join(\"\\n\")\n        parts.push(`\\n⚠️ 경고:\\n${warnText}`)\n      }\n\n      parts.push(`\\n\\n${result.markdown}`)\n\n      return {\n        content: [{ type: \"text\", text: parts.join(\"\") }],\n      }\n    } catch (err) {\n      return {\n        content: [{ type: \"text\", text: `오류: ${sanitizeError(err)}` }],\n        isError: true,\n      }\n    }\n  }\n)\n\n// ─── 도구: detect_format ─────────────────────────────\n\nserver.tool(\n  \"detect_format\",\n  \"파일의 포맷을 매직 바이트로 감지합니다 (hwpx, hwp, pdf, unknown).\",\n  {\n    file_path: z.string().min(1).describe(\"감지할 파일의 절대 경로\"),\n  },\n  async ({ file_path }) => {\n    try {\n      const resolved = safePath(file_path)\n      const format = detectFormatFromHeader(resolved)\n      return {\n        content: [{ type: \"text\", text: `${file_path}: ${format}` }],\n      }\n    } catch (err) {\n      return {\n        content: [{ type: \"text\", text: `오류: ${sanitizeError(err)}` }],\n        isError: true,\n      }\n    }\n  }\n)\n\n// ─── 도구: parse_metadata ────────────────────────────\n\nserver.tool(\n  \"parse_metadata\",\n  \"문서의 메타데이터(제목, 작성자, 날짜 등)만 빠르게 추출합니다. 전체 파싱 없이 헤더/매니페스트만 읽습니다.\",\n  {\n    file_path: z.string().min(1).describe(\"메타데이터를 추출할 문서 파일의 절대 경로\"),\n  },\n  async ({ file_path }) => {\n    try {\n      const resolved = safePath(file_path)\n      const format = detectFormatFromHeader(resolved)\n\n      if (format === \"unknown\") {\n        return {\n          content: [{ type: \"text\", text: `지원하지 않는 파일 형식입니다: ${file_path}` }],\n          isError: true,\n        }\n      }\n\n      // metadata 전용 크기 제한 (50MB)\n      const { buffer } = readValidatedFile(file_path, MAX_METADATA_FILE_SIZE)\n\n      let metadata\n      switch (format) {\n        case \"hwp\":\n          metadata = extractHwp5MetadataOnly(Buffer.from(buffer))\n          break\n        case \"hwpx\":\n          metadata = await extractHwpxMetadataOnly(buffer)\n          break\n        case \"pdf\":\n          metadata = await extractPdfMetadataOnly(buffer)\n          break\n      }\n\n      return {\n        content: [{ type: \"text\", text: JSON.stringify({ format, ...metadata }, null, 2) }],\n      }\n    } catch (err) {\n      return {\n        content: [{ type: \"text\", text: `오류: ${sanitizeError(err)}` }],\n        isError: true,\n      }\n    }\n  }\n)\n\n// ─── 도구: parse_pages ──────────────────────────────\n\nserver.tool(\n  \"parse_pages\",\n  \"문서의 특정 페이지/섹션 범위만 파싱합니다. PDF는 정확한 페이지, HWP/HWPX는 섹션 단위 근사치입니다.\",\n  {\n    file_path: z.string().min(1).describe(\"파싱할 문서 파일의 절대 경로\"),\n    pages: z.string().min(1).describe(\"페이지 범위 (예: '1-3', '1,3,5-7')\"),\n  },\n  async ({ file_path, pages }) => {\n    try {\n      const { buffer } = readValidatedFile(file_path)\n      const format = detectFormat(buffer)\n\n      if (format === \"unknown\") {\n        return {\n          content: [{ type: \"text\", text: `지원하지 않는 파일 형식입니다: ${file_path}` }],\n          isError: true,\n        }\n      }\n\n      const result = await parse(buffer, { pages })\n\n      if (!result.success) {\n        return {\n          content: [{ type: \"text\", text: `파싱 실패 (${result.fileType}): ${result.error}` }],\n          isError: true,\n        }\n      }\n\n      const meta = [\n        `포맷: ${result.fileType.toUpperCase()}`,\n        `범위: ${pages}`,\n        result.pageCount ? `페이지: ${result.pageCount}` : null,\n      ].filter(Boolean).join(\" | \")\n\n      return {\n        content: [{ type: \"text\", text: `[${meta}]\\n\\n${result.markdown}` }],\n      }\n    } catch (err) {\n      return {\n        content: [{ type: \"text\", text: `오류: ${sanitizeError(err)}` }],\n        isError: true,\n      }\n    }\n  }\n)\n\n// ─── 도구: parse_table ──────────────────────────────\n\nserver.tool(\n  \"parse_table\",\n  \"문서에서 N번째 테이블만 추출합니다 (0-based index). 테이블이 없거나 인덱스 범위를 초과하면 오류를 반환합니다.\",\n  {\n    file_path: z.string().min(1).describe(\"파싱할 문서 파일의 절대 경로\"),\n    table_index: z.number().int().min(0).describe(\"추출할 테이블 인덱스 (0부터 시작)\"),\n  },\n  async ({ file_path, table_index }) => {\n    try {\n      const { buffer } = readValidatedFile(file_path)\n      const format = detectFormat(buffer)\n\n      if (format === \"unknown\") {\n        return {\n          content: [{ type: \"text\", text: `지원하지 않는 파일 형식입니다: ${file_path}` }],\n          isError: true,\n        }\n      }\n\n      const result = await parse(buffer)\n\n      if (!result.success) {\n        return {\n          content: [{ type: \"text\", text: `파싱 실패 (${result.fileType}): ${result.error}` }],\n          isError: true,\n        }\n      }\n\n      const tableBlocks = result.blocks.filter(b => b.type === \"table\" && b.table)\n      if (tableBlocks.length === 0) {\n        return {\n          content: [{ type: \"text\", text: `문서에 테이블이 없습니다.` }],\n          isError: true,\n        }\n      }\n\n      if (table_index >= tableBlocks.length) {\n        return {\n          content: [{ type: \"text\", text: `테이블 인덱스 초과: ${table_index} (총 ${tableBlocks.length}개 테이블)` }],\n          isError: true,\n        }\n      }\n\n      const tableBlock = tableBlocks[table_index]\n      const tableMarkdown = blocksToMarkdown([tableBlock])\n\n      return {\n        content: [{ type: \"text\", text: `[테이블 #${table_index} / 총 ${tableBlocks.length}개]\\n\\n${tableMarkdown}` }],\n      }\n    } catch (err) {\n      return {\n        content: [{ type: \"text\", text: `오류: ${sanitizeError(err)}` }],\n        isError: true,\n      }\n    }\n  }\n)\n\n// ─── 도구: compare_documents ─────────────────────────\n\nserver.tool(\n  \"compare_documents\",\n  \"두 한국 문서 파일을 비교하여 추가/삭제/변경된 블록을 표시합니다. 신구대조표 생성에 활용됩니다. 크로스 포맷(HWP↔HWPX) 비교 가능.\",\n  {\n    file_path_a: z.string().min(1).describe(\"비교 원본 문서의 절대 경로\"),\n    file_path_b: z.string().min(1).describe(\"비교 대상 문서의 절대 경로\"),\n  },\n  async ({ file_path_a, file_path_b }) => {\n    try {\n      const { buffer: bufA } = readValidatedFile(file_path_a)\n      const { buffer: bufB } = readValidatedFile(file_path_b)\n\n      const result = await compare(bufA, bufB)\n      const { stats, diffs } = result\n\n      const lines: string[] = [\n        `## 문서 비교 결과`,\n        `추가: ${stats.added} | 삭제: ${stats.removed} | 변경: ${stats.modified} | 동일: ${stats.unchanged}`,\n        \"\",\n      ]\n\n      for (const d of diffs) {\n        const prefix = d.type === \"added\" ? \"+\" : d.type === \"removed\" ? \"-\" : d.type === \"modified\" ? \"~\" : \" \"\n        const text = d.after?.text || d.before?.text || (d.after?.table ? \"[테이블]\" : d.before?.table ? \"[테이블]\" : \"\")\n        const sim = d.similarity !== undefined ? ` (${(d.similarity * 100).toFixed(0)}%)` : \"\"\n        lines.push(`${prefix} ${text.substring(0, 200)}${sim}`)\n      }\n\n      return {\n        content: [{ type: \"text\", text: lines.join(\"\\n\") }],\n      }\n    } catch (err) {\n      return {\n        content: [{ type: \"text\", text: `오류: ${sanitizeError(err)}` }],\n        isError: true,\n      }\n    }\n  }\n)\n\n// ─── 도구: parse_form ───────────────────────────────\n\nserver.tool(\n  \"parse_form\",\n  \"한국 서식 문서에서 레이블-값 쌍을 구조화된 JSON으로 추출합니다. 양식/서식 문서에 최적화.\",\n  {\n    file_path: z.string().min(1).describe(\"서식 문서 파일의 절대 경로\"),\n  },\n  async ({ file_path }) => {\n    try {\n      const { buffer } = readValidatedFile(file_path)\n      const result = await parse(buffer)\n\n      if (!result.success) {\n        return {\n          content: [{ type: \"text\", text: `파싱 실패: ${result.error}` }],\n          isError: true,\n        }\n      }\n\n      const form = extractFormFields(result.blocks)\n      return {\n        content: [{ type: \"text\", text: JSON.stringify(form, null, 2) }],\n      }\n    } catch (err) {\n      return {\n        content: [{ type: \"text\", text: `오류: ${sanitizeError(err)}` }],\n        isError: true,\n      }\n    }\n  }\n)\n\n// ─── 서버 시작 ───────────────────────────────────────\n\nasync function main() {\n  const transport = new StdioServerTransport()\n  await server.connect(transport)\n}\n\nmain().catch((err) => { console.error(err); process.exit(1) })\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/mcp.ts"],"sourcesContent":["/** kordoc MCP 서버 — Claude/Cursor에서 문서 파싱 도구로 사용 */\n\nimport { McpServer } from \"@modelcontextprotocol/sdk/server/mcp.js\"\nimport { StdioServerTransport } from \"@modelcontextprotocol/sdk/server/stdio.js\"\nimport { z } from \"zod\"\nimport { readFileSync, realpathSync, openSync, readSync, closeSync, statSync } from \"fs\"\nimport { resolve, isAbsolute, extname } from \"path\"\nimport { parse, detectFormat, blocksToMarkdown, compare, extractFormFields } from \"./index.js\"\nimport { VERSION, toArrayBuffer, sanitizeError, KordocError } from \"./utils.js\"\nimport { extractHwp5MetadataOnly } from \"./hwp5/parser.js\"\nimport { extractHwpxMetadataOnly } from \"./hwpx/parser.js\"\nimport { extractPdfMetadataOnly } from \"./pdf/parser.js\"\n\n/** 허용 파일 확장자 */\nconst ALLOWED_EXTENSIONS = new Set([\".hwp\", \".hwpx\", \".pdf\", \".xlsx\", \".docx\"])\n/** 최대 파일 크기 (500MB) */\nconst MAX_FILE_SIZE = 500 * 1024 * 1024\n\n/** 경로 정규화 및 보안 검증 */\nfunction safePath(filePath: string): string {\n  if (!filePath) throw new KordocError(\"파일 경로가 비어있습니다\")\n  const resolved = resolve(filePath)\n  const real = realpathSync(resolved)\n  if (!isAbsolute(real)) throw new KordocError(\"절대 경로만 허용됩니다\")\n  const ext = extname(real).toLowerCase()\n  if (!ALLOWED_EXTENSIONS.has(ext)) throw new KordocError(`지원하지 않는 확장자입니다: ${ext} (허용: ${[...ALLOWED_EXTENSIONS].join(\", \")})`)\n  return real\n}\n\n/** 최대 파일 크기 — metadata 전용 (50MB, 전체 파싱보다 보수적) */\nconst MAX_METADATA_FILE_SIZE = 50 * 1024 * 1024\n\n/** 파일 읽기 + 크기 검증 공통 로직 */\nfunction readValidatedFile(filePath: string, maxSize = MAX_FILE_SIZE): { buffer: ArrayBuffer; resolved: string } {\n  const resolved = safePath(filePath)\n  const fileSize = statSync(resolved).size\n  if (fileSize > maxSize) {\n    throw new KordocError(`파일이 너무 큽니다: ${(fileSize / 1024 / 1024).toFixed(1)}MB (최대 ${maxSize / 1024 / 1024}MB)`)\n  }\n  const raw = readFileSync(resolved)\n  return { buffer: toArrayBuffer(raw), resolved }\n}\n\n/** 파일 헤더(16바이트)만 읽어 포맷 감지 — 전체 파일 로드 불필요 */\nfunction detectFormatFromHeader(resolved: string): ReturnType<typeof detectFormat> {\n  const fd = openSync(resolved, \"r\")\n  try {\n    const headerBuf = Buffer.alloc(16)\n    readSync(fd, headerBuf, 0, 16, 0)\n    return detectFormat(toArrayBuffer(headerBuf))\n  } finally {\n    closeSync(fd)\n  }\n}\n\nconst server = new McpServer({\n  name: \"kordoc\",\n  version: VERSION,\n})\n\n// ─── 도구: parse_document ────────────────────────────\n\nserver.tool(\n  \"parse_document\",\n  \"한국 문서 파일(HWP, HWPX, PDF, XLSX, DOCX)을 마크다운으로 변환합니다. 파일 경로를 입력하면 포맷을 자동 감지하여 텍스트를 추출합니다.\",\n  {\n    file_path: z.string().min(1).describe(\"파싱할 문서 파일의 절대 경로 (HWP, HWPX, PDF, XLSX, DOCX)\"),\n  },\n  async ({ file_path }) => {\n    try {\n      const { buffer } = readValidatedFile(file_path)\n      const format = detectFormat(buffer)\n\n      if (format === \"unknown\") {\n        return {\n          content: [{ type: \"text\", text: `지원하지 않는 파일 형식입니다: ${file_path}` }],\n          isError: true,\n        }\n      }\n\n      const result = await parse(buffer)\n\n      if (!result.success) {\n        return {\n          content: [{ type: \"text\", text: `파싱 실패 (${result.fileType}): ${result.error}` }],\n          isError: true,\n        }\n      }\n\n      const meta = [\n        `포맷: ${result.fileType.toUpperCase()}`,\n        result.pageCount ? `페이지: ${result.pageCount}` : null,\n        result.metadata?.title ? `제목: ${result.metadata.title}` : null,\n        result.metadata?.author ? `작성자: ${result.metadata.author}` : null,\n        result.isImageBased ? \"이미지 기반 PDF (텍스트 추출 불가)\" : null,\n      ].filter(Boolean).join(\" | \")\n\n      // outline/warnings 부가 정보 추가\n      const parts: string[] = [`[${meta}]`]\n\n      if (result.outline && result.outline.length > 0) {\n        const outlineText = result.outline.map(o => `${\"  \".repeat(o.level - 1)}- ${o.text}`).join(\"\\n\")\n        parts.push(`\\n📑 문서 구조:\\n${outlineText}`)\n      }\n\n      if (result.warnings && result.warnings.length > 0) {\n        const warnText = result.warnings.map(w => `- [p${w.page || \"?\"}] ${w.message}`).join(\"\\n\")\n        parts.push(`\\n⚠️ 경고:\\n${warnText}`)\n      }\n\n      parts.push(`\\n\\n${result.markdown}`)\n\n      return {\n        content: [{ type: \"text\", text: parts.join(\"\") }],\n      }\n    } catch (err) {\n      return {\n        content: [{ type: \"text\", text: `오류: ${sanitizeError(err)}` }],\n        isError: true,\n      }\n    }\n  }\n)\n\n// ─── 도구: detect_format ─────────────────────────────\n\nserver.tool(\n  \"detect_format\",\n  \"파일의 포맷을 매직 바이트로 감지합니다 (hwpx, hwp, pdf, unknown).\",\n  {\n    file_path: z.string().min(1).describe(\"감지할 파일의 절대 경로\"),\n  },\n  async ({ file_path }) => {\n    try {\n      const resolved = safePath(file_path)\n      const format = detectFormatFromHeader(resolved)\n      return {\n        content: [{ type: \"text\", text: `${file_path}: ${format}` }],\n      }\n    } catch (err) {\n      return {\n        content: [{ type: \"text\", text: `오류: ${sanitizeError(err)}` }],\n        isError: true,\n      }\n    }\n  }\n)\n\n// ─── 도구: parse_metadata ────────────────────────────\n\nserver.tool(\n  \"parse_metadata\",\n  \"문서의 메타데이터(제목, 작성자, 날짜 등)만 빠르게 추출합니다. 전체 파싱 없이 헤더/매니페스트만 읽습니다.\",\n  {\n    file_path: z.string().min(1).describe(\"메타데이터를 추출할 문서 파일의 절대 경로\"),\n  },\n  async ({ file_path }) => {\n    try {\n      const resolved = safePath(file_path)\n      const format = detectFormatFromHeader(resolved)\n\n      if (format === \"unknown\") {\n        return {\n          content: [{ type: \"text\", text: `지원하지 않는 파일 형식입니다: ${file_path}` }],\n          isError: true,\n        }\n      }\n\n      // metadata 전용 크기 제한 (50MB)\n      const { buffer } = readValidatedFile(file_path, MAX_METADATA_FILE_SIZE)\n\n      let metadata\n      switch (format) {\n        case \"hwp\":\n          metadata = extractHwp5MetadataOnly(Buffer.from(buffer))\n          break\n        case \"hwpx\":\n          metadata = await extractHwpxMetadataOnly(buffer)\n          break\n        case \"pdf\":\n          metadata = await extractPdfMetadataOnly(buffer)\n          break\n      }\n\n      return {\n        content: [{ type: \"text\", text: JSON.stringify({ format, ...metadata }, null, 2) }],\n      }\n    } catch (err) {\n      return {\n        content: [{ type: \"text\", text: `오류: ${sanitizeError(err)}` }],\n        isError: true,\n      }\n    }\n  }\n)\n\n// ─── 도구: parse_pages ──────────────────────────────\n\nserver.tool(\n  \"parse_pages\",\n  \"문서의 특정 페이지/섹션 범위만 파싱합니다. PDF는 정확한 페이지, HWP/HWPX는 섹션 단위 근사치입니다.\",\n  {\n    file_path: z.string().min(1).describe(\"파싱할 문서 파일의 절대 경로\"),\n    pages: z.string().min(1).describe(\"페이지 범위 (예: '1-3', '1,3,5-7')\"),\n  },\n  async ({ file_path, pages }) => {\n    try {\n      const { buffer } = readValidatedFile(file_path)\n      const format = detectFormat(buffer)\n\n      if (format === \"unknown\") {\n        return {\n          content: [{ type: \"text\", text: `지원하지 않는 파일 형식입니다: ${file_path}` }],\n          isError: true,\n        }\n      }\n\n      const result = await parse(buffer, { pages })\n\n      if (!result.success) {\n        return {\n          content: [{ type: \"text\", text: `파싱 실패 (${result.fileType}): ${result.error}` }],\n          isError: true,\n        }\n      }\n\n      const meta = [\n        `포맷: ${result.fileType.toUpperCase()}`,\n        `범위: ${pages}`,\n        result.pageCount ? `페이지: ${result.pageCount}` : null,\n      ].filter(Boolean).join(\" | \")\n\n      return {\n        content: [{ type: \"text\", text: `[${meta}]\\n\\n${result.markdown}` }],\n      }\n    } catch (err) {\n      return {\n        content: [{ type: \"text\", text: `오류: ${sanitizeError(err)}` }],\n        isError: true,\n      }\n    }\n  }\n)\n\n// ─── 도구: parse_table ──────────────────────────────\n\nserver.tool(\n  \"parse_table\",\n  \"문서에서 N번째 테이블만 추출합니다 (0-based index). 테이블이 없거나 인덱스 범위를 초과하면 오류를 반환합니다.\",\n  {\n    file_path: z.string().min(1).describe(\"파싱할 문서 파일의 절대 경로\"),\n    table_index: z.number().int().min(0).describe(\"추출할 테이블 인덱스 (0부터 시작)\"),\n  },\n  async ({ file_path, table_index }) => {\n    try {\n      const { buffer } = readValidatedFile(file_path)\n      const format = detectFormat(buffer)\n\n      if (format === \"unknown\") {\n        return {\n          content: [{ type: \"text\", text: `지원하지 않는 파일 형식입니다: ${file_path}` }],\n          isError: true,\n        }\n      }\n\n      const result = await parse(buffer)\n\n      if (!result.success) {\n        return {\n          content: [{ type: \"text\", text: `파싱 실패 (${result.fileType}): ${result.error}` }],\n          isError: true,\n        }\n      }\n\n      const tableBlocks = result.blocks.filter(b => b.type === \"table\" && b.table)\n      if (tableBlocks.length === 0) {\n        return {\n          content: [{ type: \"text\", text: `문서에 테이블이 없습니다.` }],\n          isError: true,\n        }\n      }\n\n      if (table_index >= tableBlocks.length) {\n        return {\n          content: [{ type: \"text\", text: `테이블 인덱스 초과: ${table_index} (총 ${tableBlocks.length}개 테이블)` }],\n          isError: true,\n        }\n      }\n\n      const tableBlock = tableBlocks[table_index]\n      const tableMarkdown = blocksToMarkdown([tableBlock])\n\n      return {\n        content: [{ type: \"text\", text: `[테이블 #${table_index} / 총 ${tableBlocks.length}개]\\n\\n${tableMarkdown}` }],\n      }\n    } catch (err) {\n      return {\n        content: [{ type: \"text\", text: `오류: ${sanitizeError(err)}` }],\n        isError: true,\n      }\n    }\n  }\n)\n\n// ─── 도구: compare_documents ─────────────────────────\n\nserver.tool(\n  \"compare_documents\",\n  \"두 한국 문서 파일을 비교하여 추가/삭제/변경된 블록을 표시합니다. 신구대조표 생성에 활용됩니다. 크로스 포맷(HWP↔HWPX) 비교 가능.\",\n  {\n    file_path_a: z.string().min(1).describe(\"비교 원본 문서의 절대 경로\"),\n    file_path_b: z.string().min(1).describe(\"비교 대상 문서의 절대 경로\"),\n  },\n  async ({ file_path_a, file_path_b }) => {\n    try {\n      const { buffer: bufA } = readValidatedFile(file_path_a)\n      const { buffer: bufB } = readValidatedFile(file_path_b)\n\n      const result = await compare(bufA, bufB)\n      const { stats, diffs } = result\n\n      const lines: string[] = [\n        `## 문서 비교 결과`,\n        `추가: ${stats.added} | 삭제: ${stats.removed} | 변경: ${stats.modified} | 동일: ${stats.unchanged}`,\n        \"\",\n      ]\n\n      for (const d of diffs) {\n        const prefix = d.type === \"added\" ? \"+\" : d.type === \"removed\" ? \"-\" : d.type === \"modified\" ? \"~\" : \" \"\n        const text = d.after?.text || d.before?.text || (d.after?.table ? \"[테이블]\" : d.before?.table ? \"[테이블]\" : \"\")\n        const sim = d.similarity !== undefined ? ` (${(d.similarity * 100).toFixed(0)}%)` : \"\"\n        lines.push(`${prefix} ${text.substring(0, 200)}${sim}`)\n      }\n\n      return {\n        content: [{ type: \"text\", text: lines.join(\"\\n\") }],\n      }\n    } catch (err) {\n      return {\n        content: [{ type: \"text\", text: `오류: ${sanitizeError(err)}` }],\n        isError: true,\n      }\n    }\n  }\n)\n\n// ─── 도구: parse_form ───────────────────────────────\n\nserver.tool(\n  \"parse_form\",\n  \"한국 서식 문서에서 레이블-값 쌍을 구조화된 JSON으로 추출합니다. 양식/서식 문서에 최적화.\",\n  {\n    file_path: z.string().min(1).describe(\"서식 문서 파일의 절대 경로\"),\n  },\n  async ({ file_path }) => {\n    try {\n      const { buffer } = readValidatedFile(file_path)\n      const result = await parse(buffer)\n\n      if (!result.success) {\n        return {\n          content: [{ type: \"text\", text: `파싱 실패: ${result.error}` }],\n          isError: true,\n        }\n      }\n\n      const form = extractFormFields(result.blocks)\n      return {\n        content: [{ type: \"text\", text: JSON.stringify(form, null, 2) }],\n      }\n    } catch (err) {\n      return {\n        content: [{ type: \"text\", text: `오류: ${sanitizeError(err)}` }],\n        isError: true,\n      }\n    }\n  }\n)\n\n// ─── 서버 시작 ───────────────────────────────────────\n\nasync function main() {\n  const transport = new StdioServerTransport()\n  await server.connect(transport)\n}\n\nmain().catch((err) => { console.error(err); process.exit(1) })\n"],"mappings":"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","names":[]}

package/dist/page-range-737B4EZW.js

@@ -0,0 +1,8 @@
+#!/usr/bin/env node
+import {
+  parsePageRange
+} from "./chunk-MOL7MDBG.js";
+export {
+  parsePageRange
+};
+//# sourceMappingURL=page-range-737B4EZW.js.map

package/dist/page-range-737B4EZW.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/utils-OTCR2KMY.js

@@ -0,0 +1,22 @@
+#!/usr/bin/env node
+import {
+  KordocError,
+  VERSION,
+  classifyError,
+  isPathTraversal,
+  precheckZipSize,
+  sanitizeError,
+  sanitizeHref,
+  toArrayBuffer
+} from "./chunk-UUKFY5P5.js";
+export {
+  KordocError,
+  VERSION,
+  classifyError,
+  isPathTraversal,
+  precheckZipSize,
+  sanitizeError,
+  sanitizeHref,
+  toArrayBuffer
+};
+//# sourceMappingURL=utils-OTCR2KMY.js.map

package/dist/utils-OTCR2KMY.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/{watch-AKTZTPVF.js → watch-JFDOENIO.js}

@@ -1,14 +1,17 @@
 #!/usr/bin/env node
 import {
   detectFormat,
-  parse,
+  parse
+} from "./chunk-QQ6PZADA.js";
+import {
   toArrayBuffer
-} from "./chunk-NJ3R7LNR.js";
+} from "./chunk-UUKFY5P5.js";
+import "./chunk-MOL7MDBG.js";
 
 // src/watch.ts
 import { watch, readFileSync, writeFileSync, mkdirSync, statSync, existsSync } from "fs";
 import { basename, resolve, extname } from "path";
-var SUPPORTED_EXTENSIONS = /* @__PURE__ */ new Set([".hwp", ".hwpx", ".pdf"]);
+var SUPPORTED_EXTENSIONS = /* @__PURE__ */ new Set([".hwp", ".hwpx", ".pdf", ".xlsx", ".docx"]);
 var DEBOUNCE_MS = 1e3;
 var STABLE_CHECK_MS = 300;
 var MAX_FILE_SIZE = 500 * 1024 * 1024;
@@ -41,6 +44,8 @@ async function watchDirectory(options) {
     const fileName = basename(filePath);
     try {
       const absPath = resolve(dir, filePath);
+      const realDir = resolve(dir);
+      if (!absPath.startsWith(realDir)) return;
       if (!existsSync(absPath)) return;
       const fileSize = await waitForStableSize(absPath);
       if (fileSize > MAX_FILE_SIZE || fileSize === 0) return;
@@ -98,7 +103,10 @@ function validateWebhookUrl(url) {
     throw new Error(`\uD5C8\uC6A9\uB418\uC9C0 \uC54A\uB294 webhook \uD504\uB85C\uD1A0\uCF5C: ${parsed.protocol}`);
   }
   const hostname = parsed.hostname.toLowerCase();
-  if (hostname === "localhost" || hostname === "[::1]" || hostname.startsWith("127.") || hostname.startsWith("10.") || hostname.startsWith("192.168.") || /^172\.(1[6-9]|2\d|3[01])\./.test(hostname) || hostname === "0.0.0.0" || hostname.startsWith("169.254.") || hostname.endsWith(".local")) {
+  if (hostname === "localhost" || hostname === "[::1]" || hostname.startsWith("127.") || hostname.startsWith("10.") || hostname.startsWith("192.168.") || /^172\.(1[6-9]|2\d|3[01])\./.test(hostname) || hostname === "0.0.0.0" || hostname.startsWith("169.254.") || hostname.endsWith(".local") || // IPv6 사설 대역
+  hostname.startsWith("[fc") || hostname.startsWith("[fd") || hostname.startsWith("[fe80:") || hostname === "[::0]" || hostname === "[::]" || // 클라우드 메타데이터 엔드포인트
+  hostname === "metadata.google.internal" || hostname === "metadata.google" || // 16진수/8진수 IP 인코딩 우회 방지
+  /^0x[0-9a-f]+$/i.test(hostname) || /^0[0-7]+$/.test(hostname)) {
     throw new Error(`\uB0B4\uBD80 \uB124\uD2B8\uC6CC\uD06C \uB300\uC0C1 webhook\uC740 \uD5C8\uC6A9\uB418\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4: ${hostname}`);
   }
 }
@@ -117,4 +125,4 @@ async function sendWebhook(url, payload) {
 export {
   watchDirectory
 };
-//# sourceMappingURL=watch-AKTZTPVF.js.map
+//# sourceMappingURL=watch-JFDOENIO.js.map

package/dist/watch-JFDOENIO.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/watch.ts"],"sourcesContent":["/** 디렉토리 감시 모드 — 새 문서 자동 변환 + Webhook 알림 */\n\nimport { watch, readFileSync, writeFileSync, mkdirSync, statSync, existsSync } from \"fs\"\nimport { basename, resolve, extname } from \"path\"\nimport { parse, detectFormat } from \"./index.js\"\nimport { toArrayBuffer } from \"./utils.js\"\nimport type { WatchOptions } from \"./types.js\"\n\nconst SUPPORTED_EXTENSIONS = new Set([\".hwp\", \".hwpx\", \".pdf\", \".xlsx\", \".docx\"])\nconst DEBOUNCE_MS = 1000\n/** 파일 쓰기 완료 판정: 연속 2회 동일 크기 확인 간격 */\nconst STABLE_CHECK_MS = 300\nconst MAX_FILE_SIZE = 500 * 1024 * 1024\n\n/**\n * 디렉토리를 감시하여 새 문서 파일을 자동 변환.\n *\n * @example\n * ```bash\n * kordoc watch ./incoming -d ./output --webhook https://api.example.com/docs\n * ```\n */\nexport async function watchDirectory(options: WatchOptions): Promise<void> {\n  const { dir, outDir, webhook, format = \"markdown\", pages, silent } = options\n\n  if (!existsSync(dir)) throw new Error(`디렉토리를 찾을 수 없습니다: ${dir}`)\n  if (webhook) validateWebhookUrl(webhook)\n  if (outDir) mkdirSync(outDir, { recursive: true })\n\n  const log = silent ? () => {} : (msg: string) => process.stderr.write(msg + \"\\n\")\n  log(`[kordoc watch] 감시 시작: ${resolve(dir)}`)\n  if (outDir) log(`[kordoc watch] 출력: ${resolve(outDir)}`)\n  if (webhook) log(`[kordoc watch] 웹훅: ${webhook}`)\n\n  // 디바운스 맵\n  const pending = new Map<string, ReturnType<typeof setTimeout>>()\n\n  /** 파일 크기가 안정화될 때까지 대기 (쓰기 완료 감지) */\n  const waitForStableSize = async (absPath: string): Promise<number> => {\n    let prevSize = statSync(absPath).size\n    await new Promise(r => setTimeout(r, STABLE_CHECK_MS))\n    if (!existsSync(absPath)) return 0\n    const currSize = statSync(absPath).size\n    if (currSize !== prevSize) {\n      // 크기가 변했으면 한 번 더 대기\n      await new Promise(r => setTimeout(r, STABLE_CHECK_MS))\n      if (!existsSync(absPath)) return 0\n      return statSync(absPath).size\n    }\n    return currSize\n  }\n\n  const processFile = async (filePath: string) => {\n    const ext = extname(filePath).toLowerCase()\n    if (!SUPPORTED_EXTENSIONS.has(ext)) return\n\n    const fileName = basename(filePath)\n    try {\n      const absPath = resolve(dir, filePath)\n      // 경로 순회 방지 — 감시 디렉토리 외부 파일 차단\n      const realDir = resolve(dir)\n      if (!absPath.startsWith(realDir)) return\n      if (!existsSync(absPath)) return\n\n      const fileSize = await waitForStableSize(absPath)\n      if (fileSize > MAX_FILE_SIZE || fileSize === 0) return\n\n      log(`[kordoc watch] 변환 중: ${fileName}`)\n\n      const buffer = readFileSync(absPath)\n      const arrayBuffer = toArrayBuffer(buffer)\n      const parseOptions = pages ? { pages } : undefined\n      const result = await parse(arrayBuffer, parseOptions)\n\n      if (!result.success) {\n        log(`[kordoc watch] 실패: ${fileName} — ${result.error}`)\n        await sendWebhook(webhook, { file: fileName, format: detectFormat(arrayBuffer), success: false, error: result.error })\n        return\n      }\n\n      const output = format === \"json\" ? JSON.stringify(result, null, 2) : result.markdown\n\n      if (outDir) {\n        const outExt = format === \"json\" ? \".json\" : \".md\"\n        const outPath = resolve(outDir, fileName.replace(/\\.[^.]+$/, outExt))\n        writeFileSync(outPath, output, \"utf-8\")\n        log(`[kordoc watch] 완료: ${fileName} → ${basename(outPath)}`)\n      } else {\n        process.stdout.write(output + \"\\n\")\n      }\n\n      await sendWebhook(webhook, {\n        file: fileName,\n        format: result.fileType,\n        success: true,\n        markdown: format === \"markdown\" ? output.substring(0, 1000) : undefined,\n      })\n    } catch (err) {\n      log(`[kordoc watch] 에러: ${fileName} — ${err instanceof Error ? err.message : err}`)\n    }\n  }\n\n  // fs.watch recursive (Node 18+ Windows/macOS, Node 19+ Linux)\n  watch(dir, { recursive: true }, (event, filename) => {\n    if (!filename) return\n    const filePath = filename.toString()\n\n    // 디바운스\n    const existing = pending.get(filePath)\n    if (existing) clearTimeout(existing)\n    pending.set(filePath, setTimeout(() => {\n      pending.delete(filePath)\n      processFile(filePath).catch(() => {})\n    }, DEBOUNCE_MS))\n  })\n\n  // 프로세스 종료 방지 (Ctrl+C로 종료)\n  return new Promise(() => {})\n}\n\n/** Webhook URL 검증 — SSRF 방지: http/https만 허용, localhost/private IP 차단 */\nfunction validateWebhookUrl(url: string): void {\n  let parsed: URL\n  try {\n    parsed = new URL(url)\n  } catch {\n    throw new Error(`유효하지 않은 webhook URL: ${url}`)\n  }\n  if (parsed.protocol !== \"http:\" && parsed.protocol !== \"https:\") {\n    throw new Error(`허용되지 않는 webhook 프로토콜: ${parsed.protocol}`)\n  }\n  const hostname = parsed.hostname.toLowerCase()\n  if (\n    hostname === \"localhost\" ||\n    hostname === \"[::1]\" ||\n    hostname.startsWith(\"127.\") ||\n    hostname.startsWith(\"10.\") ||\n    hostname.startsWith(\"192.168.\") ||\n    /^172\\.(1[6-9]|2\\d|3[01])\\./.test(hostname) ||\n    hostname === \"0.0.0.0\" ||\n    hostname.startsWith(\"169.254.\") ||\n    hostname.endsWith(\".local\") ||\n    // IPv6 사설 대역\n    hostname.startsWith(\"[fc\") ||\n    hostname.startsWith(\"[fd\") ||\n    hostname.startsWith(\"[fe80:\") ||\n    hostname === \"[::0]\" ||\n    hostname === \"[::]\" ||\n    // 클라우드 메타데이터 엔드포인트\n    hostname === \"metadata.google.internal\" ||\n    hostname === \"metadata.google\" ||\n    // 16진수/8진수 IP 인코딩 우회 방지\n    /^0x[0-9a-f]+$/i.test(hostname) ||\n    /^0[0-7]+$/.test(hostname)\n  ) {\n    throw new Error(`내부 네트워크 대상 webhook은 허용되지 않습니다: ${hostname}`)\n  }\n}\n\nasync function sendWebhook(url: string | undefined, payload: Record<string, unknown>): Promise<void> {\n  if (!url) return\n  try {\n    validateWebhookUrl(url)\n    await fetch(url, {\n      method: \"POST\",\n      headers: { \"Content-Type\": \"application/json\" },\n      body: JSON.stringify({ ...payload, timestamp: new Date().toISOString() }),\n    })\n  } catch {\n    // webhook 실패는 조용히 무시\n  }\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -1,75 +1,77 @@
-{
-  "name": "kordoc",
-  "version": "1.7.2",
-  "description": "Parse Korean documents (HWP, HWPX, PDF) to Markdown",
-  "type": "module",
-  "exports": {
-    ".": {
-      "types": "./dist/index.d.ts",
-      "import": "./dist/index.js",
-      "require": "./dist/index.cjs"
-    }
-  },
-  "main": "./dist/index.cjs",
-  "module": "./dist/index.js",
-  "types": "./dist/index.d.ts",
-  "bin": {
-    "kordoc": "./dist/cli.js",
-    "kordoc-mcp": "./dist/mcp.js"
-  },
-  "files": [
-    "dist"
-  ],
-  "scripts": {
-    "build": "tsup",
-    "dev": "tsup --watch",
-    "test": "node --import tsx --test tests/*.test.ts",
-    "prepublishOnly": "npm run test && npm run build"
-  },
-  "keywords": [
-    "hwp",
-    "hwpx",
-    "hancom",
-    "hangul",
-    "korean",
-    "document",
-    "parser",
-    "pdf",
-    "markdown",
-    "converter",
-    "mcp",
-    "model-context-protocol"
-  ],
-  "author": "chrisryugj",
-  "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/chrisryugj/kordoc.git"
-  },
-  "engines": {
-    "node": ">=18"
-  },
-  "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.28.0",
-    "@xmldom/xmldom": "^0.9.8",
-    "cfb": "1.2.2",
-    "commander": "^13.0.0",
-    "jszip": "^3.10.1",
-    "zod": "^3.23.0"
-  },
-  "peerDependencies": {
-    "pdfjs-dist": ">=4.0.0"
-  },
-  "peerDependenciesMeta": {
-    "pdfjs-dist": {
-      "optional": true
-    }
-  },
-  "devDependencies": {
-    "@types/node": "^18.19.130",
-    "pdfjs-dist": "^4.10.38",
-    "tsup": "^8.4.0",
-    "tsx": "^4.21.0",
-    "typescript": "^5.9.0"
-  }
-}
+{
+  "name": "kordoc",
+  "version": "1.8.0",
+  "description": "Parse Korean documents (HWP, HWPX, PDF, XLSX, DOCX) to Markdown",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "kordoc": "./dist/cli.js",
+    "kordoc-mcp": "./dist/mcp.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "test": "node --import tsx --test tests/*.test.ts",
+    "prepublishOnly": "npm run test && npm run build"
+  },
+  "keywords": [
+    "hwp",
+    "hwpx",
+    "hancom",
+    "hangul",
+    "korean",
+    "document",
+    "parser",
+    "pdf",
+    "xlsx",
+    "docx",
+    "markdown",
+    "converter",
+    "mcp",
+    "model-context-protocol"
+  ],
+  "author": "chrisryugj",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/chrisryugj/kordoc.git"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.28.0",
+    "@xmldom/xmldom": "^0.9.8",
+    "cfb": "1.2.2",
+    "commander": "^13.0.0",
+    "jszip": "^3.10.1",
+    "zod": "^3.23.0"
+  },
+  "peerDependencies": {
+    "pdfjs-dist": ">=4.0.0"
+  },
+  "peerDependenciesMeta": {
+    "pdfjs-dist": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@types/node": "^18.19.130",
+    "pdfjs-dist": "^4.10.38",
+    "tsup": "^8.4.0",
+    "tsx": "^4.21.0",
+    "typescript": "^5.9.0"
+  }
+}