hwpx-mcp-server

Overview

The hwpx-mcp-server provides comprehensive tools for working with HWPX (Hangul Word Processor XML) documents through the Model Context Protocol. It supports reading document metadata, text extraction, search and replace operations, paragraph and table editing, style management, and document conversion. The server is cross-platform and works with various MCP clients including Claude Desktop, VS Code, and Gemini CLI. It maintains a clear separation between basic editing operations and advanced validation tools, with safety features like automatic backup before edits and document copying for safe workflows.

Try asking AI

After installing, here are 6 things you can ask your AI assistant:

• get_document_info

  문서 메타데이터, 섹션, 문단, 표 개수 조회

  Try:이 문서의 기본 정보를 알려줘Try:문서에 몇 개의 표가 있어?
• get_document_text

  문서 전체 텍스트 추출

  Try:이 문서의 전체 내용을 텍스트로 보여줘Try:문서 내용을 5000자까지 요약해줘
• find_text

  키워드 검색과 주변 문맥 반환

  Try:문서에서 '프로젝트'가 언급된 부분을 찾아줘Try:'결과'와 관련된 내용을 검색해봐
• search_and_replace

  단일 텍스트 치환

  Try:문서의 '회사'를 '기업'으로 바꿔줘Try:'2023'을 '2024'로 전체 변경해줘
• copy_document

  원본을 건드리기 전에 작업용 사본 생성

  Try:이 문서를 복사해서 작용용 파일 만들어줘Try:수정하기 전에 백업본 생성해줘
• add_paragraph

  문단 추가

  Try:문서 맨 끝에 새 문단 추가해줘Try:'결론' 제목의 문단 뒤에 내용을 추가해줘
• set_table_cell_text

  셀 텍스트 수정

  Try:첫 번째 표의 첫 번째 셀 내용을 '테스트'로 변경해줘Try:'이름' 셀에 '홍길동' 입력해줘
• get_table_map

  표 위치, 크기, 헤더 문맥을 빠르게 탐색

  Try:문서에 있는 모든 표의 위치를 알려줘Try:두 번째 표의 구조를 설명해줘
• hwpx_to_markdown

  HWPX 문서를 Markdown으로 변환

  Try:이 문서를 Markdown 형식으로 변환해줘Try:HWPX 파일을 마크다운으로 변환해서 보여줘
• get_document_outline

  제목과 개요 구조 추출

  Try:이 문서의 목차 구조를 알려줘Try:문서의 개요를 보여줘
• add_table

  표 생성

  Try:3x5 크기의 새 표를 추가해줘Try:문서 끝에 헤더가 있는 표를 만들어줘
• format_text

  텍스트 범위 서식 적용

  Try:'결론' 부분을 굵게 해줘Try:특정 단어에 강조 표시를 추가해줘

Comparable tools

Installation

uvx hwpx-mcp-server

pip install hwpx-mcp-server
hwpx-mcp-server

{
  "mcpServers": {
    "hwpx": {
      "command": "uvx",
      "args": ["hwpx-mcp-server"]
    }
  }
}

FAQ

Can this server work with .hwp files?

No, this server only supports Open XML-based .hwpx format, not the binary .hwp format.

Is Hangul word processor required?

No, the server processes documents using pure Python without needing Hangul word processor installed.

How do I safely edit documents?

First use copy_document to create a working copy, then make edits on the copy rather than the original.

Compare hwpx-mcp-server with