Skip to main content
Glama

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
RHWP_EXENo사용할 rhwp 실행 파일 경로 지정 (CLI: --rhwp-path EXE, 기본값: 자동 탐색/다운로드)
HWP_EDIT_ROOTSNo접근 허용 폴더 지정 (CLI: --root DIR 반복, Windows는 ';', 그 외는 ':' 구분, 기본값: 제한 없음)
HWP_EDIT_LOG_FILENo서버 로그를 파일에도 기록 (기본값: stderr만 출력)
HWP_EDIT_CACHE_DIRNorhwp 캐시 저장 경로 덮어쓰기 (기본값: OS 기본 캐시)
HWP_EDIT_MAX_CHARSNo도구 응답 최대 문자 수 상한20000
HWP_EDIT_READ_ONLYNo쓰기 도구를 등록하지 않고 읽기·검사 도구만 노출 (CLI: --read-only, 기본값: 비활성)
HWP_EDIT_NO_DOWNLOADNorhwp 자동 내려받기 비활성화 (오프라인 환경용, 기본값: 비활성)

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

CapabilityDetails
tools
{
  "listChanged": false
}
prompts
{
  "listChanged": false
}
resources
{
  "subscribe": false,
  "listChanged": false
}
experimental
{}

Tools

Functions exposed to the LLM to take actions

NameDescription
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

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

TDQS

A3.5/5.0

Scored across 14 tools

Disambiguation4/5

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).

Naming Consistency5/5

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.

Tool Count5/5

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.

Completeness4/5

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.

Maintenance

ActivityMaintained
ResponsivenessNo recent community issues