HwpSAFE

[](https://mseep.ai/app/jkf87-hwp-mcp)

[](https://github.com/jkf87/hwp-mcp)

HWP-MCP는 한글 워드 프로세서(HWP)를 Claude와 같은 AI 모델이 제어할 수 있도록 해주는 Model Context Protocol(MCP) 서버입니다. 이 프로젝트는 한글 문서를 자동으로 생성, 편집, 조작하는 기능을 AI에게 제공합니다.

주요 기능

• 문서 생성 및 관리: 새 문서 생성, 열기, 저장 기능
• 텍스트 편집: 텍스트 삽입, 글꼴 설정, 단락 추가
• 테이블 작업: 테이블 생성, 데이터 채우기, 셀 내용 설정
• 완성된 문서 생성: 템플릿 기반 보고서 및 편지 자동 생성
• 일괄 작업: 여러 작업을 한 번에 실행하는 배치 기능

시스템 요구사항

• Windows 운영체제
• 한글(HWP) 프로그램 설치
• Python 3.10 이상 (mcp 패키지 요구사항)
• 필수 Python 패키지 (requirements.txt 참조)

macOS/Linux 또는 한글이 설치되지 않은 환경에서도 서버는 실행되며, 이 경우 hwp_read_file(HWP 파일 읽기)만 사용할 수 있습니다.

설치 방법

1. 저장소 클론:

git clone https://github.com/jkf87/hwp-mcp.git
cd hwp-mcp

1. 의존성 설치:

pip install -r requirements.txt

1. (선택사항) MCP 패키지 설치:

pip install "mcp<2"

사용 방법

Claude와 함께 사용하기

Claude 데스크톱 설정 파일에 다음과 같이 HWP-MCP 서버를 등록하세요:

{
"mcpServers": {
"hwp": {
"command": "python",
"args": ["경로/hwp-mcp/hwp_mcp_stdio_server.py"]
}
}
}

주요 기능 예시

HWP 파일 읽기 (한글 프로그램 불필요, 모든 OS)

hwp_read_file("경로/문서.hwp")  # 본문 텍스트 반환, 표는 Markdown 표로 변환

새 문서 생성

hwp_create()

텍스트 삽입

hwp_insert_text("원하는 텍스트를 입력하세요.")

테이블 생성 및 데이터 입력

# 테이블 생성
hwp_insert_table(rows=5, cols=2)

# 테이블에 데이터 채우기
hwp_fill_table_with_data([
["월", "판매량"], 
["1월", "120"], 
["2월", "150"], 
["3월", "180"], 
["4월", "200"]
], has_header=True)

# 표에 연속된 숫자 채우기
hwp_fill_column_numbers(start=1, end=10, column=1, from_first_cell=True)

문서 저장

hwp_save("경로/문서명.hwp")

일괄 작업 예시

hwp_batch_operations([
{"operation": "hwp_create"},
{"operation": "hwp_insert_text", "params": {"text": "제목"}},
{"operation": "hwp_set_font", "params"