hwpx-mcp-server

概述

hwpx-mcp-server通过模型上下文协议(MCP)提供处理HWPX(韩文文字处理器XML)文档的全面工具。它支持读取文档元数据、文本提取、搜索替换操作、段落和表格编辑、样式管理以及文档转换。该服务器跨平台运行，可与Claude Desktop、VS Code和Gemini CLI等多种MCP客户端配合使用。它保持了基本编辑操作和高级验证工具之间的明确区分，并包含安全功能，如编辑前的自动备份和用于安全工作流的文档复制。

试试问 AI

装完之后，这里有 6 个你可以让 AI 做的事：

• get_document_info

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

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

  문서 전체 텍스트 추출

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

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

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

  단일 텍스트 치환

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

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

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

  문단 추가

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

  셀 텍스트 수정

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

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

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

  HWPX 문서를 Markdown으로 변환

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

  제목과 개요 구조 추출

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

  표 생성

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

  텍스트 범위 서식 적용

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

可对比工具

安装

uvx hwpx-mcp-server

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

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

FAQ

此服务器能否处理.hwp文件？

不能，此服务器仅支持基于Open XML的.hwpx格式，不支持二进制.hwp格式。

是否需要安装韩文文字处理器？

不需要，服务器使用纯Python处理文档，无需安装韩文文字处理器。

如何安全地编辑文档？

首先使用copy_document创建工作副本，然后在副本上进行编辑而不是直接编辑原始文件。

hwpx-mcp-server 对比