본문 바로가기
M MCP모아

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

HWPX 자동화 MCP (파이썬) — HWPX 문서 읽기·편집·양식 채움·검증을 위한 로컬 우선 Python MCP 서버

airmang/python-hwpx-automation

한컴 없이 HWPX 양식 채움·편집·검증을 안전하게 수행하는 Python 기반 MCP 서버

실험적 보안 점검 통과 ⚖ Apache 2.0 원클릭 ★ 69 업데이트 4일 전
Claude Code Cursor Cline 호환

설치

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

claude mcp add -e 'HWPX_AUTOMATION_WORKSPACE_ROOTS=["~/Documents"]' hwpx -- uvx --from 'python-hwpx-automation[mcp]==7.3.1' hwpx-automation-mcp

이 MCP가 해결하는 문제

HWPX 문서를 AI가 직접 수정하면 구조가 깨지거나 원본이 손상될 위험이 있습니다. 이 서버는 사본 생성, 최소 편집, 저장 전 무결성 검증 게이트를 거치는 방식으로 양식 채움과 텍스트 수정을 수행하고 작업 폴더 밖 접근을 막습니다. 반복 문서 업무를 로컬에서 자동화하는 데 쓸 수 있습니다.

보안 점검

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

외부 전송 없이 로컬에서 동작하며 경로 탈출·SSRF 방어가 있고, 서브프로세스는 한컴 렌더 용도로만 쓰입니다.

통과한 점검

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

유의사항

  • 변경 확인 — 영향 없음: 7커밋은 문서 편집 기능 개선과 실행 파일 탐색 강화이며 네트워크·새 셸 실행 추가 없음. PyPI 7.5.0(11-11)
  • workspace root 밖 경로 traversal·symlink escape 를 기본 거부하고, URL 입력은 HTTPS·공개 IP 만 허용합니다(사설망 허용은 환경변수로 명시 해제).
  • subprocess 는 office/rendering 의 한컴 렌더(macOS osascript, Windows PowerShell COM) 경로에서만 사용되며 임의 명령 실행 도구는 없습니다.
  • PyPI 패키지는 trusted publishing·액션 SHA 고정·CodeQL·Dependabot 으로 배포되며 SECURITY.md 가 있습니다.
  • 수정 도구는 호출 즉시 저장되므로 사본에서 작업할 것을 README가 권고합니다.
  • 기존 이름 hwpx-mcp-server(PyPI)는 이 패키지를 설치하는 호환용 껍데기입니다.

데이터·키 전송 대상

외부 전송 없음 (로컬 파일 처리)URL 입력 시에만 사용자가 지정한 공개 HTTPS 주소 조회

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

한국어 사용 예시

양식 문서 채우기

~/Documents/신청서.hwpx 양식을 분석해서 성명과 소속 칸을 채우고 채운 결과를 검증해줘

공문 서식 점검

공문.hwpx 가 행정 문서 서식 규정에 맞는지 점검하고 고칠 부분을 알려줘

마크다운으로 새 문서 생성

아래 회의 결과를 마크다운으로 정리해서 meeting-result.hwpx 새 문서로 만들어줘

자주 묻는 질문

한컴오피스나 Windows가 필요한가요?

필요하지 않습니다. README에 따르면 한컴오피스도 Windows도 없이 동작하며, 한컴 렌더 기반 PDF 생성(render-pdf)만 macOS 한컴오피스 또는 Windows 한글 COM 이 있는 컴퓨터에서 선택적으로 쓸 수 있습니다.

처음 설정할 때 꼭 지정해야 할 값이 있나요?

HWPX_AUTOMATION_WORKSPACE_ROOTS 에 문서가 있는 폴더를 JSON 배열로 지정하는 것을 권장합니다. 비워 두면 GUI 클라이언트에서는 시스템 디렉터리에서 실행되어 모든 문서 경로가 막힙니다.

원본 문서가 안전한가요?

수정 도구는 호출 즉시 저장되므로 README는 copy_document 로 사본을 만든 뒤 작업하고, 수정 후 다시 읽어 확인하라고 안내합니다. 기본 자동 백업(.bak)도 켜져 있습니다.

연동 API

한컴 HWPX(OWPML) 한/글 렌더 오라클(선택)

관련 MCP

HWPX 문서 편집 MCP

Dayoooun/hwpx-mcp

실험적 보안 점검 통과

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

개발도구·AI·유틸 한컴 HWPX(OWPML)한/글 PDF 변환(선택) 원클릭
★ 36 ↓ 68/주 13일 전
Claude Code Cursor Cline

업스테이지 공문서 HWPX MCP

UpstageAI/korean-report-hwpx

공식 실험적 보안 점검 통과

보고서·보도자료·기안문을 기관 서식 HWPX로 만드는 업스테이지 공식 MCP

개발도구·AI·유틸 한컴 HWPX(OWPML)정책브리핑 보도자료 서식 원클릭
★ 24 ↓ 337/주 1일 전
Claude Code Cursor Cline

한포지(HwpForge)

ai-screams/HwpForge

실험적 보안 점검 통과

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

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

관련 가이드

전체 MCP 가이드 보기 →

리뷰 · 후기

후기 내려받기(CSV)
–

0개의 후기

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

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