hwp-edit-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| RHWP_EXE | No | 사용할 rhwp 실행 파일 경로 지정 (CLI: --rhwp-path EXE, 기본값: 자동 탐색/다운로드) | |
| HWP_EDIT_ROOTS | No | 접근 허용 폴더 지정 (CLI: --root DIR 반복, Windows는 ';', 그 외는 ':' 구분, 기본값: 제한 없음) | |
| HWP_EDIT_LOG_FILE | No | 서버 로그를 파일에도 기록 (기본값: stderr만 출력) | |
| HWP_EDIT_CACHE_DIR | No | rhwp 캐시 저장 경로 덮어쓰기 (기본값: OS 기본 캐시) | |
| HWP_EDIT_MAX_CHARS | No | 도구 응답 최대 문자 수 상한 | 20000 |
| HWP_EDIT_READ_ONLY | No | 쓰기 도구를 등록하지 않고 읽기·검사 도구만 노출 (CLI: --read-only, 기본값: 비활성) | |
| HWP_EDIT_NO_DOWNLOAD | No | rhwp 자동 내려받기 비활성화 (오프라인 환경용, 기본값: 비활성) |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
한컴오피스 GUI/COM 없이 rhwp 엔진으로 .hwp/.hwpx 문서를 안전하게 읽고 편집하는 헤드리스 MCP 서버입니다. 모든 도구는 file_path 를 필수로 받으며, 모든 쓰기 작업은 SafeWriter(해시 충돌 검사, .hwp-mcp-history 스냅샷, 재열기 무손실 검증, 원자 교체)를 경유합니다.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| hwp_infoB | HWP/HWPX 문서의 메타데이터(형식, 페이지 수, 문단 수, 글꼴, SHA-256 해시 등)를 조회합니다. file_path는 절대 경로 권장. |
| hwp_get_textB | HWP/HWPX 문서의 본문 텍스트를 추출합니다. format='text' 또는 'markdown'을 지원합니다. file_path는 절대 경로 권장. |
| hwp_searchC | 문서 내에서 특정 문자열을 검색하여 페이지 번호, 문맥, 표 셀 좌표를 반환합니다. file_path는 절대 경로 권장. |
| hwp_table_viewA | 문서 내 표(Table)의 행/열 크기, 병합 정보, 각 셀의 좌표(row, col) 및 텍스트를 반환합니다. table_index(0부터 시작)로 특정 표만 조회할 수 있습니다. file_path는 절대 경로 권장. |
| hwp_fill_cellsA | 표의 셀 값을 일괄 채웁니다. 각 항목은 좌표 기준({'row': 0, 'col': 1, 'text': '값'}) 또는 라벨 기준({'label': '성명', 'text': '홍길동', 'direction': 'right'|'below'})을 지원합니다. 라벨 기준에서 표 번호('table' 또는 table_index)를 생략하면 모든 표를 앞에서부터 찾아 첫 일치를 씁니다. 좌표 기준에서 표 번호를 생략하면 0번 표입니다. SafeWriter를 통해 스냅샷 백업 및 무손실 검증 후 원자 교체합니다. file_path는 절대 경로 권장. |
| hwp_replace_textC | 문서 본문 및 표 셀 내의 텍스트를 찾아 일괄 치환합니다. SafeWriter를 경유합니다. file_path는 절대 경로 권장. |
| hwp_fill_fieldsC | 문서 내 누름틀(필드) 값을 이름 기준으로 채웁니다. SafeWriter를 경유합니다. file_path는 절대 경로 권장. |
| hwp_insert_textC | 지정한 섹션/문단/문자 오프셋 위치에 텍스트를 삽입합니다. SafeWriter를 경유합니다. file_path는 절대 경로 권장. |
| hwp_run_planB | rhwp 선언적 편집 계획서(plan JSON)를 일괄 실행합니다. input/output 경로는 SafeWriter가 안전하게 바인딩합니다. file_path는 절대 경로 권장. |
| hwp_render_pageA | 문서 페이지를 PNG 또는 SVG 이미지 파일로 렌더링하여 저장 경로를 반환합니다(시각 확인용). page는 0부터 시작하며, -1이면 전체 페이지를 렌더합니다. file_path는 절대 경로 권장. |
| hwp_historyA | 문서의 SafeWriter 스냅샷 히스토리(.hwp-mcp-history) 목록을 최신순으로 조회합니다. file_path는 절대 경로 권장. |
| hwp_restoreA | hwp_history에서 확인한 snapshot_id 로 문서를 복원합니다. 복원 전 현재 파일도 스냅샷으로 백업한 뒤 원자 교체합니다. file_path는 절대 경로 권장. |
| hwp_diffA | 두 문서 파일(file_path_a vs file_path_b) 또는 현재 문서와 스냅샷(snapshot_id) 간의 텍스트 unified diff 를 반환합니다. file_path_a는 절대 경로 권장. |
| hwp_rhwp_callB | rhwp 가 제공하는 180여 개 전체 도구 중 하나를 직접 호출하는 탈출구입니다. output 인자를 받는 쓰기 도구는 SafeWriter를 경유해 임시 파일 출력·검증·원자 교체를 수행합니다. file_path는 절대 경로 권장. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 14 tools
The core read tools (info, get_text, search, table_view) and write tools (replace_text, insert_text, fill_cells, fill_fields) target clearly distinct resources or actions. However, hwp_rhwp_call and hwp_run_plan are broad meta-tools that can perform any edit, creating some genuine overlap with the individual edit tools (e.g., an agent may wonder whether to replace text directly or via a plan/rhwp call).
Every tool uses a consistent hwp_ prefix with snake_case naming throughout (hwp_get_text, hwp_fill_cells, hwp_replace_text, etc.). The verb/noun style is uniform and predictable across the whole set.
14 tools is well-scoped for a document editing server, with each tool covering a distinct lifecycle operation (read, edit, render, history/restore). No tool feels redundant or padding.
Covers a strong surface: metadata, text extraction, search, table inspection, cell/field filling, text replace/insert, render, diff, history, and restore. Minor gaps exist (no dedicated table creation or content deletion), but hwp_rhwp_call and hwp_run_plan provide escape-hatch coverage for those cases.