본문 바로가기
M MCP모아

MCP모아는 정보 제공 목적입니다. 보안·라이선스·동작 책임은 이용자에게 있습니다.

HWPX 문서 편집 MCP — 한글 한컴 설치 없이 HWPX 문서를 읽고 쓰는 125개 도구의 MCP 서버

Dayoooun/hwpx-mcp

한글 프로그램 없이 HWPX 문서의 문단·표·스타일을 편집하는 크로스플랫폼 MCP 서버

실험적 보안 점검 통과 ⚖ MIT 원클릭 ★ 36 업데이트 13일 전
Claude Code Cursor Cline 호환

설치

터미널에서 실행하세요. 기본은 이 프로젝트 전용(local, ~/.claude.json)으로 저장됩니다. 팀과 공유하려면 --scope project(프로젝트 루트 .mcp.json), 모든 프로젝트에서 쓰려면 --scope user 를 붙이세요. 확인: claude mcp list 또는 Claude Code 세션 안에서 /mcp

claude mcp add hwpx-mcp -- npx -y @kimdayoun/hwpx-mcp

이 MCP가 해결하는 문제

HWPX는 한국 공공·업무 문서의 표준이지만 AI가 문서 구조를 안전하게 수정하기는 까다롭습니다. 이 서버는 HWPX의 XML 구조를 직접 다뤄 표 셀 수정, 서식 보존 텍스트 교체, 이미지 삽입 등을 도구로 제공하며 원자적 저장으로 파일 손상을 방지합니다. 한글이 설치되지 않은 서버·Linux 환경에서도 사용할 수 있습니다.

보안 점검

2026-11-16 점검
보안 점검 통과

네트워크 호출이 없고 child_process 는 한컴 PDF 변환(PowerShell/osascript) 용도로만 쓰이며 설치 스크립트가 없습니다.

통과한 점검

  • 데이터·API키 외부 유출 없음
  • 악성 설치 스크립트 없음
  • 하드코딩 크리덴셜·백도어 없음
  • 임의 셸 실행 없음
  • 제3자 서버 경유 없음
  • 자격증명 평문 저장 없음

유의사항

  • 서버 소스(index.ts, HwpxDocument.ts, HwpxParser.ts, PdfExport.ts)에서 fetch·http 호출이 확인되지 않았습니다.
  • PdfExport.ts 의 child_process.spawn 은 고정된 한컴 변환 스크립트(Windows PowerShell COM, macOS 네이티브 hwp2pdf)만 실행하며 경로는 환경변수로 전달됩니다.
  • npm 패키지에 postinstall 스크립트가 없습니다(prepublishOnly 만 존재).
  • mjyoo2/hwp-extension 의 포크이며, 저장소에 디버그 로그·작업 메모 파일이 일부 포함되어 있습니다.
  • 도구 수가 125개로 많아 일부 클라이언트에서 도구 목록이 길어질 수 있습니다.

데이터·키 전송 대상

외부 전송 없음 (로컬 파일 처리)

GitHub 저장소 직접 점검 — README·매니페스트(package.json/pyproject)·서버 소스·설치 스크립트·패키지 레지스트리(npm/PyPI/JSR) 대조. 공개 소스 기준의 자동+수동 검토 의견이며 완전성·무오류를 보증하지 않습니다. 시점 이후 변경될 수 있습니다.

한국어 사용 예시

양식 표의 셀 일괄 채우기

신청서.hwpx 의 첫 번째 표에서 성명, 소속, 연락처 칸을 아래 정보로 채우고 서식은 그대로 유지해줘

서식 유지한 채 문구 교체

공문.hwpx 에서 '2025년'을 모두 '2026년'으로 바꾸고 글꼴과 정렬은 바꾸지 말아줘

문서 구조 파악 후 요약

보고서.hwpx 의 표 목록과 각 표 헤더를 먼저 보여주고, 본문 핵심을 다섯 줄로 요약해줘

자주 묻는 질문

한글 프로그램이 설치되어 있어야 하나요?

HWPX 읽기·편집에는 필요하지 않습니다. README에 따르면 ZIP+XML 구조를 Node.js로 직접 처리하며, PDF 내보내기(export_to_pdf)만 Windows 한/글 또는 macOS 한/글 for Mac 이 필요합니다.

API 키나 요금이 있나요?

API 키는 필요 없고 MIT 라이선스 오픈소스입니다.

어떤 OS에서 쓸 수 있나요?

Windows, macOS, Linux 모두에서 MCP 서버가 동작합니다. 다만 PDF 내보내기는 Linux에서 지원되지 않습니다.

연동 API

한컴 HWPX(OWPML) 한/글 PDF 변환(선택)

관련 MCP

HWPX 자동화 MCP (파이썬)

airmang/python-hwpx-automation

실험적 보안 점검 통과

HWPX 문서 읽기·편집·양식 채움·검증을 위한 로컬 우선 Python MCP 서버

개발도구·AI·유틸 한컴 HWPX(OWPML)한/글 렌더 오라클(선택) 원클릭
★ 69 ↓ 3.8k/주 4일 전
Claude Code Cursor Cline

한포지(HwpForge)

ai-screams/HwpForge

실험적 보안 점검 통과

한글(HWPX) 문서를 AI 에이전트가 읽고 쓰고 변환할 수 있게 해주는 MCP 서버

개발도구·AI·유틸 한컴 한글 HWPX (KS X 6101) 원클릭
★ 20 ↓ 261/주 오늘
Claude Code Cursor Codex

코르독 (KorDoc)

chrisryugj/kordoc

실험적 보안 점검 통과

HWP·HWPX·PDF·XLSX·DOCX 등 한국 공문서를 Markdown으로 변환하는 MCP 서버

★ 3,038 ↓ 75.6k/주 오늘
Claude Code Cursor

관련 가이드

전체 MCP 가이드 보기 →

리뷰 · 후기

후기 내려받기(CSV)
–

0개의 후기

설치해보셨다면 다른 분들을 위해 평가를 남겨주세요.

아직 후기가 없습니다. 첫 후기를 남겨주세요!