← kordoc

kordoc 4.12.3

npm · kordoc · current release

15
Tools
0
Resources
0
Templates
0
Prompts

Observation

Observed 2026-09-05T13:26:47.481Z using mcpSecurity-inventory. Status: succeeded. Negotiated protocol: 2025-06-18.

Server capabilities
{
  "tools": {
    "listChanged": true
  }
}

Tools 15

ToolCategoryAnnotationsRisk
compare_documents두 한국 문서 파일을 비교하여 추가/삭제/변경된 블록을 표시합니다. 신구대조표 생성에 활용됩니다. 크로스 포맷(HWP↔HWPX) 비교 가능.
Input schema
{
  "type": "object",
  "properties": {
    "file_path_a": {
      "type": "string",
      "minLength": 1,
      "description": "비교 원본 문서의 절대 경로"
    },
    "file_path_b": {
      "type": "string",
      "minLength": 1,
      "description": "비교 대상 문서의 절대 경로"
    }
  },
  "required": [
    "file_path_a",
    "file_path_b"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}
— · —
detect_format파일의 포맷을 매직 바이트로 감지합니다 (hwpx, hwp, hwp3, hwpml, pdf, xls, xlsx, docx, unknown).
Input schema
{
  "type": "object",
  "properties": {
    "file_path": {
      "type": "string",
      "minLength": 1,
      "description": "감지할 파일의 절대 경로"
    }
  },
  "required": [
    "file_path"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}
— · —
extract_profile참조 HWPX 문서에서 표 서식 프로필(테두리·음영·열 너비·셀 글꼴)을 JSON으로 추출합니다. 추출한 프로필을 generate_document의 profile_path로 넘기면 원본 문서 없이 같은 표 서식을 재현합니다 — "이 문서 표 서식 그대로 만들어줘" 워크플로의 1단계.
Input schema
{
  "type": "object",
  "properties": {
    "hwpx_path": {
      "type": "string",
      "minLength": 1,
      "description": "서식을 추출할 참조 HWPX 파일의 절대 경로"
    },
    "output_path": {
      "type": "string",
      "minLength": 1,
      "description": "프로필 JSON 출력 절대 경로 (.json 권장)"
    }
  },
  "required": [
    "hwpx_path",
    "output_path"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}
— · —
fill_form한국 서식 문서의 빈칸을 채워서 새 문서로 출력합니다. hwpx-preserve를 사용하면 원본 서식(테두리, 폰트, 병합 등)을 100% 유지합니다. HWPX 누름틀(CLICK_HERE) 필드는 이름으로 정확 매칭되어 우선 채워집니다. file_path 대신 template으로 내장 정부 표준 기안문 서식을 쓸 수 있습니다 — gian(일반기안문, 별지 제1호서식: 행정기관명·수신자·경유·제목·본문·붙임·발신명의·기안자·검토자·결재권자 등 23필드) / gian-simple(간이기안문, 별지 제2호서식: 내부결재용 13필드).
Input schema
{
  "type": "object",
  "properties": {
    "file_path": {
      "type": "string",
      "minLength": 1,
      "description": "서식 템플릿 문서의 절대 경로 (HWP, HWPX, PDF, XLSX, DOCX). template 사용 시 생략"
    },
    "template": {
      "type": "string",
      "enum": [
        "gian",
        "gian-simple",
        "일반기안문",
        "간이기안문"
      ],
      "description": "내장 정부 표준 서식 이름 — file_path 대신 사용. gian=일반기안문(별지 제1호서식), gian-simple=간이기안문(별지 제2호서식)"
    },
    "fields": {
      "type": "object",
      "additionalProperties": {
        "type": "string"
      },
      "description": "채울 필드 맵 (라벨 → 값). 예: {\"성명\": \"홍길동\", \"전화번호\": \"010-1234-5678\"}"
    },
    "formats": {
      "type": "object",
      "additionalProperties": {
        "type": "string"
      },
      "description": "필드별 값 서식 (라벨 → 포맷). 정준값 하나로 서식마다 다른 모양을 채울 때: date:yy.mm.dd / phone:hyphen·dot·digits / rrn:hyphen·masked / mask:###-## / 자유 패턴(yyyy년 m월 d일, ###-####-####)"
    },
    "require_unique": {
      "type": "boolean",
      "description": "한 키가 서식의 2곳 이상에 매칭되면 채우지 않고 거부 — 반복 라벨 양식에서 남의 블록 오염 방지 (배열 값은 예외)"
    },
    "mask_values": {
      "type": "boolean",
      "description": "응답에 값 대신 글자수만 표시 — 개인정보 채움 시 값이 대화 로그에 남지 않게"
    },
    "output_format": {
      "type": "string",
      "enum": [
        "markdown",
        "hwpx",
        "hwpx-preserve"
      ],
      "default": "hwpx-preserve",
      "description": "출력 포맷: hwpx-preserve (원본 스타일 보존, HWPX 전용), hwpx (새 HWPX 생성), markdown"
    },
    "output_path": {
      "type": "string",
      "description": "출력 파일 저장 경로 (선택). 지정 시 파일로 저장, 미지정 시 텍스트로 반환"
    }
  },
  "required": [
    "fields"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}
— · —
generate_document마크다운을 HWPX 한글 문서로 생성합니다. "보고서로/공문서로/개조식으로/계획서로 뽑아줘·만들어줘" 요청이 이 도구입니다. 프리셋 매핑: 정부 표준 보고서(표지·목차·로마숫자 장헤더 자동)='개조식', 기안문·시행문·알림공문='기안문', 1페이지 요약보고서='보고서', 추진계획='계획서'. 표는 실측 정부 서식(헤더 음영+이중선·외곽 굵은선·내용 비례 열폭), 쪽번호·결재란·'끝.' 표시 지원. ⚠ 생성 전 확인 권장: 문서종류(보고서/기안문)·제목·기관명(org)·날짜·목차 여부가 불명확하면 사용자에게 물어보세요 — 엉뚱한 프리셋 선택이 가장 흔한 오생성 원인. 마크다운 규칙: #(h1)=문서 제목(표지), ##(h2)=장(Ⅰ Ⅱ Ⅲ 자동), 리스트 깊이=□ ○ - ㆍ 부호, ※시작 문단=참고 스타일, <right>텍스트</right>=우측정렬 출처행. (원본 서식 보존 제자리 수정은 patch_document, 서식 빈칸 채우기는 fill_form)
Input schema
{
  "type": "object",
  "properties": {
    "markdown": {
      "type": "string",
      "minLength": 1,
      "description": "HWPX로 변환할 마크다운 전문. 표는 GFM 문법 사용 (예: '| 이름 | 부서 |\\n| --- | --- |\\n| 홍길동 | 기획팀 |')"
    },
    "output_path": {
      "type": "string",
      "minLength": 1,
      "description": "출력 HWPX 파일의 절대 경로 (.hwpx 권장)"
    },
    "profile_path": {
      "type": "string",
      "description": "서식 프로필 JSON 경로 (extract_profile로 추출) — 참조 문서의 표 테두리·음영·열폭·셀 글꼴을 재현. 표 행·열 수와 첫 셀 텍스트가 일치하는 표에만 적용"
    },
    "preset": {
      "type": "string",
      "enum": [
        "official",
        "기안문",
        "시행문",
        "공문",
        "공문서",
        "report",
        "보고서",
        "plan",
        "계획서",
        "계획",
        "notice",
        "통지",
        "알림",
        "안내",
        "minutes",
        "회의록",
        "gaejosik",
        "개조식",
        "개조식보고서",
        "정부보고서",
        "정부표준개조식보고서",
        "press",
        "보도자료"
      ],
      "description": "공문서 프리셋 — 지정 시 한국 행정 공문서 표준 서식 적용. '개조식'=정부 표준 개조식 보고서(표지·목차·로마숫자 장 헤더 자동 + □○-※ 부호별 폰트), '보도자료'=머리박스+제목 25pt+□→ㅇ→*(각주) 체계. 미지정 시 범용 마크다운 변환"
    },
    "font": {
      "type": "string",
      "enum": [
        "myeongjo",
        "gothic"
      ],
      "description": "본문 글꼴(공문서 모드): myeongjo=명조 계열(개조식·보고서·계획서는 실측 휴먼명조, 그 외 함초롬바탕), gothic=맑은 고딕"
    },
    "body_pt": {
      "type": "integer",
      "minimum": 6,
      "maximum": 40,
      "description": "본문 글자 크기(pt, 공문서 모드). 기본: 기안문 12, 보고서·계획서·통지 15"
    },
    "line_spacing": {
      "type": "integer",
      "minimum": 50,
      "maximum": 300,
      "description": "본문 줄간격(%, 공문서 모드). 기본: 프리셋별 실측값(기안문 160, 회의록 130 등)"
    },
    "org": {
      "type": "string",
      "description": "표지 기관명 (표지를 켜는 모든 프리셋에서 사용 가능). 미지정 시 표지에 기관명 생략"
    },
    "date": {
      "type": "string",
      "description": "표지 날짜 ('YYYY. M. D.' 표기 권장). 미지정 시 오늘 날짜"
    },
    "toc": {
      "type": "boolean",
      "description": "목차 페이지 생성 여부 — h2 목록을 Ⅰ Ⅱ Ⅲ 장으로 자동 구성. 전 프리셋 사용 가능(보도자료 제외). 미지정 시 개조식 프리셋만 켜짐"
    },
    "cover": {
      "type": "boolean",
      "description": "표지 페이지 생성 여부 — 첫 h1을 제목으로 파랑 장식 표지. 전 프리셋 사용 가능(보도자료 제외 — 머리박스 서식과 양립 불가). 미지정 시 개조식 프리셋만 켜짐 (org/date 지정 시 자동 켜짐)"
    },
    "approval": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "maxItems": 6,
      "description": "결재란 직위 라벨 (최대 6개, 예: ['담당','팀장','과장']) — 문서 최상단 우측에 서명 공란 결재 표 생성"
    },
    "page_numbers": {
      "type": "boolean",
      "description": "쪽번호(하단 중앙 '- 1 -', 표지·목차 카운트 제외). 미지정 시 개조식·보고서·계획서 켜짐"
    },
    "end_mark": {
      "type": "boolean",
      "description": "본문 끝 '끝.' 표시 (행정업무규정). 미지정 시 기안문만 켜짐, 본문이 이미 '끝.'으로 끝나면 중복 생성 안 함"
    },
    "body_title_box": {
      "type": "boolean",
      "description": "본문 첫 페이지 제목 반복 박스 (개조식 실측 관행). 미지정 시 개조식+표지 조합에서 켜짐"
    },
    "h2_marker": {
      "type": "string",
      "enum": [
        "box",
        "number",
        "none"
      ],
      "description": "h2 섹션 제목 말머리(비개조식): box='□ 제목'(실측 보고서 관행), number='1. 제목'(공고문 관행), none=말머리 없음. 미지정 시 보고서·계획서 box, 그 외 none"
    },
    "fonts": {
      "type": "object",
      "properties": {
        "body": {
          "type": "string"
        },
        "heading": {
          "type": "string"
        },
        "ref": {
          "type": "string"
        },
        "table": {
          "type": "string"
        }
      },
      "additionalProperties": false,
      "description": "요소별 글꼴 오버라이드(공문서 모드) — body=본문(○·-)/heading=제목 계열(□·장헤더·표지·목차)/ref=※ 참고/table=표 셀. 개조식·보고서·계획서는 네 역할 전부, 그 외 프리셋은 body만 적용"
    },
    "sizes": {
      "type": "object",
      "properties": {
        "dae": {
          "type": "number",
          "minimum": 6,
          "maximum": 60
        },
        "cham": {
          "type": "number",
          "minimum": 6,
          "maximum": 60
        },
        "chapter": {
          "type": "number",
          "minimum": 6,
          "maximum": 60
        },
        "coverTitle": {
          "type": "number",
          "minimum": 6,
          "maximum": 60
        },
        "coverSub": {
          "type": "number",
          "minimum": 6,
          "maximum": 60
        },
        "tocLabel": {
          "type": "number",
          "minimum": 6,
          "maximum": 60
        },
        "tocRoman": {
          "type": "number",
          "minimum": 6,
          "maximum": 60
        },
        "tocItem": {
          "type": "number",
          "minimum": 6,
          "maximum": 60
        },
        "table": {
          "type": "number",
          "minimum": 6,
          "maximum": 60
        },
        "bodyTitle": {
          "type": "number",
          "minimum": 6,
          "maximum": 60
        }
      },
      "additionalProperties": false,
      "description": "개조식 요소별 글자 크기(pt) 오버라이드 — dae=□/cham=※/chapter=장헤더/coverTitle·coverSub=표지/tocLabel·tocRoman·tocItem=목차/table=표 셀/bodyTitle=본문 첫 페이지 제목 반복 박스. 미지정 요소는 body_pt 비례 기본값"
    },
    "levels": {
      "type": "object",
      "additionalProperties": {
        "type": "object",
        "properties": {
          "font": {
            "type": "string"
          },
          "pt": {
            "type": "number",
            "minimum": 6,
            "maximum": 60
          },
          "bold": {
            "type": "boolean"
          }
        },
        "additionalProperties": false
      },
      "propertyNames": {
        "pattern": "^[0-7]$"
      },
      "description": "항목부호 단계별 위계 타이포(공문서 모드, v4.12.3) — {\"0\":{font:\"HY견고딕\",pt:17,bold:true},\"1\":{font:\"한컴돋움\",bold:true}} 꼴(depth 0~7). 실측: 전자결재 기안문 □/ㅇ/- 계열은 □=HY견고딕 +2~3pt 굵게·ㅇ=한컴돋움 굵게·-=휴먼명조 본문. 법정 8단계(1. 가.)는 본문 동일이 관행이라 기본 미적용"
    },
    "bullet2": {
      "type": "string",
      "enum": [
        "ㅇ",
        "○"
      ],
      "description": "2단계 항목부호 — 'ㅇ'(이응, 전자결재 기안문·공고문 실측 지배) / '○'(원, 보고서 양식). 미지정 시 통지·보도자료 ㅇ, 그 외 ○"
    },
    "suppress_single": {
      "type": "boolean",
      "description": "단일 형제 항목 부호 생략(편람 규정, 법정 번호 standard 전용 — 불릿 체계인 보고서·계획서·개조식·보도자료엔 무효). 기본 false — 하나뿐인 항목에도 부호(1. 가.)를 부여 (부호 없는 계단 들여쓰기가 실무 눈에 어색)"
    },
    "doc_head": {
      "type": "object",
      "properties": {
        "org": {
          "type": "string"
        },
        "to": {
          "type": "string"
        },
        "via": {
          "type": "string"
        },
        "title": {
          "type": "string"
        }
      },
      "additionalProperties": false,
      "description": "기안문 두문(별지 제1호서식) — org=행정기관명(18pt bold 중앙)/to=수신/via=경유/title=제목. 기안문 프리셋 전용"
    },
    "doc_foot": {
      "type": "object",
      "properties": {
        "sender": {
          "type": "string"
        },
        "drafter": {
          "type": "string"
        },
        "reviewer": {
          "type": "string"
        },
        "approver": {
          "type": "string"
        },
        "cooperator": {
          "type": "string"
        },
        "docNum": {
          "type": "string"
        },
        "receive": {
          "type": "string"
        },
        "address": {
          "type": "string"
        },
        "site": {
          "type": "string"
        },
        "phone": {
          "type": "string"
        },
        "fax": {
          "type": "string"
        },
        "email": {
          "type": "string"
        },
        "disclosure": {
          "type": "string"
        }
      },
      "additionalProperties": false,
      "description": "기안문 결문 — sender=발신명의(22pt 중앙)/drafter·reviewer·approver=기안·검토·결재/docNum=시행/receive=접수/disclosure=공개구분 등. 기안문 프리셋 전용"
    },
    "report_info": {
      "type": "string",
      "description": "업무보고 우상단 보고정보 행 — 예: '(2026. 7. 11., 과장 홍길동, ☎02-120)' (실측: 12pt 우측정렬)"
    },
    "notice_head": {
      "type": "object",
      "properties": {
        "no": {
          "type": "string"
        },
        "date": {
          "type": "string"
        },
        "sender": {
          "type": "string"
        }
      },
      "additionalProperties": false,
      "description": "공고문 두문·결문 — no=공고번호(본문 위 bold)/date=날짜(본문 아래 우측)/sender=발신명의(우측 bold). 통지 프리셋 전용"
    },
    "press": {
      "type": "object",
      "properties": {
        "release": {
          "type": "string"
        },
        "distribute": {
          "type": "string"
        },
        "sub": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "contact": {
          "type": "object",
          "properties": {
            "dept": {
              "type": "string"
            },
            "manager": {
              "type": "string"
            },
            "phone": {
              "type": "string"
            }
          },
          "additionalProperties": false
        }
      },
      "additionalProperties": false,
      "description": "보도자료 옵션 — release=보도시점/distribute=배포일(머리박스)/sub=부제 배열('- … -')/contact=담당 부서·담당자·연락처 표"
    },
    "paper": {
      "type": "string",
      "enum": [
        "A4",
        "A3",
        "B4",
        "B5",
        "Letter"
      ],
      "description": "용지 크기 (v4.5.0). 기본 A4"
    },
    "landscape": {
      "type": "boolean",
      "description": "용지 가로 방향 (v4.5.0). 기본 세로"
    },
    "columns": {
      "type": "integer",
      "minimum": 1,
      "maximum": 8,
      "description": "다단 개수 (v4.5.0). 기본 1단"
    },
    "header": {
      "type": "string",
      "description": "머리말 텍스트 — 모든 쪽 상단, 인라인 마크다운 허용 (v4.5.0)"
    },
    "footer": {
      "type": "string",
      "description": "꼬리말 텍스트 — 모든 쪽 하단 (v4.5.0)"
    },
    "image_dir": {
      "type": "string",
      "description": "마크다운 이미지 참조(![](x.png))를 이 디렉토리에서 읽어 실데이터 임베드 (v4.5.0, PNG/JPEG/GIF/BMP). 미지정 시 참조만 placeholder로 보존"
    }
  },
  "required": [
    "markdown",
    "output_path"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}
— · —
parse_chunks문서를 RAG용 구조 청크 JSON으로 파싱합니다. 헤딩·개조식 위계(□○- / 1.·가.·1))가 breadcrumb 경로로 보존되고 표는 독립 청크로 나옵니다 — 임베딩·인덱싱 전처리용. 자르기(토큰 상한·오버랩)는 소비자 몫입니다.
Input schema
{
  "type": "object",
  "properties": {
    "file_path": {
      "type": "string",
      "minLength": 1,
      "description": "대상 문서의 절대 경로 (HWP/HWPX/PDF/XLSX/DOCX)"
    },
    "granularity": {
      "type": "string",
      "enum": [
        "section",
        "block"
      ],
      "default": "section",
      "description": "section=같은 breadcrumb 아래 연속 텍스트 병합(기본), block=IRBlock 1개=청크 1개"
    },
    "include_table_cells": {
      "type": "boolean",
      "default": false,
      "description": "표 청크에 셀 텍스트 2차원 배열 포함 여부"
    }
  },
  "required": [
    "file_path"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}
— · —
parse_document한국 문서 파일(HWP, HWPX, PDF, XLSX, DOCX)과 이미지(PNG/JPG/WebP)를 마크다운으로 변환합니다. 파일 경로를 입력하면 포맷을 자동 감지하여 텍스트를 추출합니다. 이미지는 OCR(내장 PP-OCRv5)이 자동 적용되고 표 괘선도 복원됩니다.
Input schema
{
  "type": "object",
  "properties": {
    "file_path": {
      "type": "string",
      "minLength": 1,
      "description": "파싱할 문서 파일의 절대 경로 (HWP, HWPX, PDF, XLSX, DOCX, PNG/JPG/WebP)"
    },
    "ocr": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "string",
          "const": "force"
        }
      ],
      "description": "스캔/이미지 PDF 텍스트 OCR (내장 PP-OCRv5 korean, 첫 사용 시 ~18MB 자동 다운로드). true=텍스트층이 없거나 깨진 페이지만 인식하고 정상 페이지는 그대로 둡니다. \"force\"=텍스트층이 있어도 무시하고 전 페이지 강제 재인식. parse 결과에 NEEDS_OCR 경고가 있으면 이 옵션으로 재시도하세요"
    },
    "remove_header_footer": {
      "type": "boolean",
      "description": "PDF 머리글/바닥글 자동 제거 (기본 true — false로 끄기, CLI --no-header-footer 대응)"
    },
    "formula_ocr": {
      "type": "boolean",
      "description": "PDF 수식 OCR 활성화 (MFD+MFR ONNX, 첫 사용 시 모델 ~155MB 자동 다운로드, CLI --formula-ocr 대응)"
    },
    "dedupe_running_headers": {
      "type": "boolean",
      "description": "HWP5 레이아웃 표 페이지 반복 러닝 헤더 중복 제거 (기본 off — 붙임별 재번호 오삭제 주의, CLI --dedupe-headers 대응)"
    },
    "keep_trailing_empty_cols": {
      "type": "boolean",
      "description": "표 오른쪽 끝 빈 열(서식 입력란) 보존 (#47, 기본 off: 후행 빈 열 트림, CLI --keep-empty-cols 대응)"
    },
    "keep_empty_paragraphs": {
      "type": "boolean",
      "description": "빈 문단 보존 — 본문은 빈 paragraph 블록, 표 셀은 빈 줄 (#57, 기본 off, CLI --keep-empty-paragraphs 대응)"
    },
    "password": {
      "type": "string",
      "description": "암호로 보호된 문서의 열기 암호 (#59, HWPX·HWP3·HWP5 지원. 파싱이 ENCRYPTED로 실패하면 이 옵션으로 재시도하세요. 한컴 DRM 보호 문서는 해당 없음)"
    },
    "tables": {
      "type": "boolean",
      "description": "PDF 표 감지 (기본 true — false로 끄기, CLI --no-tables 대응). 테두리 박스를 표로 오인해 읽기 순서가 뒤집히는 문서(2단 시험지 등)에서 자연 읽기순 텍스트만 뽑습니다 (#64)"
    }
  },
  "required": [
    "file_path"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}
— · —
parse_form한국 서식 문서에서 레이블-값 쌍을 구조화된 JSON으로 추출합니다. 양식/서식 문서에 최적화.
Input schema
{
  "type": "object",
  "properties": {
    "file_path": {
      "type": "string",
      "minLength": 1,
      "description": "서식 문서 파일의 절대 경로"
    }
  },
  "required": [
    "file_path"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}
— · —
parse_metadata문서의 메타데이터(제목, 작성자, 날짜 등)만 빠르게 추출합니다. 전체 파싱 없이 헤더/매니페스트만 읽습니다.
Input schema
{
  "type": "object",
  "properties": {
    "file_path": {
      "type": "string",
      "minLength": 1,
      "description": "메타데이터를 추출할 문서 파일의 절대 경로"
    }
  },
  "required": [
    "file_path"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}
— · —
parse_pages문서의 특정 페이지 범위만 파싱합니다. PDF와 한컴 저장본 HWP/HWPX는 실제 페이지 기준(metadata.pageMode=layout), 조판 캐시가 없는 생성 파일은 섹션 단위 근사(pageMode=section)입니다.
Input schema
{
  "type": "object",
  "properties": {
    "file_path": {
      "type": "string",
      "minLength": 1,
      "description": "파싱할 문서 파일의 절대 경로"
    },
    "pages": {
      "type": "string",
      "minLength": 1,
      "description": "페이지 범위 (예: '1-3', '1,3,5-7')"
    }
  },
  "required": [
    "file_path",
    "pages"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}
— · —
parse_table문서에서 N번째 테이블만 추출합니다 (0-based index). 테이블이 없거나 인덱스 범위를 초과하면 오류를 반환합니다.
Input schema
{
  "type": "object",
  "properties": {
    "file_path": {
      "type": "string",
      "minLength": 1,
      "description": "파싱할 문서 파일의 절대 경로"
    },
    "table_index": {
      "type": "integer",
      "minimum": 0,
      "description": "추출할 테이블 인덱스 (0부터 시작)"
    }
  },
  "required": [
    "file_path",
    "table_index"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}
— · —
patch_document원본 HWPX/HWP의 서식(글꼴·표·도장칸·이미지)을 1바이트도 건드리지 않고, 편집된 마크다운의 바뀐 텍스트만 제자리 치환해 새 문서로 출력합니다. parse_document로 얻은 마크다운을 수정해 넘기세요 — 양식 빈칸 채우기·문구 수정에 적합하며 한컴 한글에서 변조 경고 없이 열립니다. (블록 추가/삭제·표 구조 변경은 미지원, 미적용 항목은 결과에 보고)
Input schema
{
  "type": "object",
  "properties": {
    "file_path": {
      "type": "string",
      "minLength": 1,
      "description": "원본 문서의 절대 경로 (HWPX 또는 HWP 5.x)"
    },
    "edited_markdown": {
      "type": "string",
      "minLength": 1,
      "description": "parse_document 출력 마크다운을 편집한 전체 마크다운. 바뀐 문단/셀 텍스트만 반영하고 블록 수·순서는 원본과 같게 유지하세요"
    },
    "output_path": {
      "type": "string",
      "minLength": 1,
      "description": "출력 파일 저장 절대 경로 (원본과 같은 확장자: .hwpx 또는 .hwp)"
    }
  },
  "required": [
    "file_path",
    "edited_markdown",
    "output_path"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}
— · —
place_seal도장/서명 이미지를 앵커 문구("(인)"·"서명 또는 인" 등) 위에 부유(글 앞) 배치합니다. 표/페이지를 키우지 않습니다 (HWPX 전용).
Input schema
{
  "type": "object",
  "properties": {
    "file_path": {
      "type": "string",
      "minLength": 1,
      "description": "대상 HWPX 문서의 절대 경로"
    },
    "image_path": {
      "type": "string",
      "minLength": 1,
      "description": "도장/서명 이미지 절대 경로 (투명 배경 PNG 권장)"
    },
    "anchor": {
      "type": "string",
      "default": "(인)",
      "description": "앵커 문구 — 이 문구 기준으로 배치"
    },
    "occurrence": {
      "type": "integer",
      "minimum": 0,
      "default": 0,
      "description": "같은 앵커가 여럿일 때 0-based 선택"
    },
    "size_mm": {
      "type": "number",
      "exclusiveMinimum": 0,
      "description": "도장 한 변 크기 mm (기본: 줄높이×1.6, 7~18 클램프)"
    },
    "mode": {
      "type": "string",
      "enum": [
        "overlap",
        "right",
        "auto"
      ],
      "default": "auto",
      "description": "overlap=문구 위 겹침, right=문구 오른쪽 옆, auto=공간 있으면 right"
    },
    "dx_mm": {
      "type": "number",
      "description": "x 미세조정 mm"
    },
    "dy_mm": {
      "type": "number",
      "description": "y 미세조정 mm"
    },
    "output_path": {
      "type": "string",
      "minLength": 1,
      "description": "출력 HWPX 저장 경로"
    }
  },
  "required": [
    "file_path",
    "image_path",
    "output_path"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}
— · —
redact_document문서의 개인정보(주민번호·전화·이메일·카드·계좌)를 탐지해 서식 보존 마스킹합니다. HWPX/HWP는 원본 서식 1바이트 그대로 patch, 그 외 포맷은 마스킹된 마크다운으로 출력. 자동 검출 보조 도구 — 결과 리포트를 사람이 최종 확인해야 하며 이미지 안 텍스트는 탐지하지 못합니다. 마스킹 후 render_document로 눈으로 확인하는 것을 권장합니다.
Input schema
{
  "type": "object",
  "properties": {
    "file_path": {
      "type": "string",
      "minLength": 1,
      "description": "대상 문서의 절대 경로"
    },
    "rules": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "rrn",
          "phone",
          "email",
          "card",
          "account",
          "passport",
          "driver"
        ]
      },
      "description": "적용 룰 (기본: rrn·phone·email·card·account — passport·driver는 opt-in)"
    },
    "mask_char": {
      "type": "string",
      "minLength": 1,
      "maxLength": 1,
      "description": "마스크 문자 1글자 (기본: ●)"
    },
    "output_path": {
      "type": "string",
      "minLength": 1,
      "description": "출력 경로 (HWPX/HWP는 같은 확장자, 그 외는 .md) — dry_run이 아니면 필수"
    },
    "dry_run": {
      "type": "boolean",
      "default": false,
      "description": "탐지 리포트만 반환, 파일 미생성"
    }
  },
  "required": [
    "file_path"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}
— · —
render_documentHWPX 문서를 실제 조판 그대로 렌더해 PNG 이미지(또는 SVG 파일)로 돌려줍니다. generate_document·fill_form·patch_document·place_seal 결과물을 눈으로 확인하는 용도 — 생성/수정 후 이 도구로 렌더해 깨짐·잘림·배치를 검증하고 다시 고치는 루프를 권장합니다. 한컴 저장본은 조판 캐시로, AI 생성본(캐시 없음)은 순수 조판 엔진(reflow)으로 렌더되며 후자는 한컴 실조판의 근사입니다 (참고용 미리보기).
Input schema
{
  "type": "object",
  "properties": {
    "file_path": {
      "type": "string",
      "minLength": 1,
      "description": "렌더할 HWPX 파일의 절대 경로"
    },
    "format": {
      "type": "string",
      "enum": [
        "png",
        "svg"
      ],
      "default": "png",
      "description": "png=이미지로 응답에 직접 반환 (sharp 필요, 기본 설치됨) / svg=output_path에 파일 저장"
    },
    "output_path": {
      "type": "string",
      "minLength": 1,
      "description": "결과 저장 경로 (png는 선택, svg는 필수 — 확장자는 format과 일치)"
    },
    "highlights": {
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1
      },
      "description": "형광펜 표시할 검색어 목록 — 채운 값·수정 문구 위치 확인용"
    },
    "reflow_mode": {
      "type": "string",
      "enum": [
        "keep",
        "charAll"
      ],
      "default": "keep",
      "description": "reflow 줄바꿈: keep=어절 단위, charAll=글자 단위"
    }
  },
  "required": [
    "file_path"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}
— · —

Resources 0

Resource templates 0

Prompts 0

Let’s talk about MCP security.

Share your details and our security team will contact you.