Advanced HWP MCP Server

Advanced HWP MCP Server

고도화된 한글(HWP) MCP 서버 - 한글의 모든 기능을 제어할 수 있는 MCP 서버입니다.

🚀 주요 기능

기본 문서 제어

• ✅ 새 문서 생성 (create_document)
• ✅ 문서 열기 (open_document)
• ✅ 문서 저장 (save_document)
• ✅ 문서 정보 조회 (get_document_info)

고급 텍스트 조작

• ✅ 정밀한 텍스트 위치 지정 (insert_text_at_position)
• ✅ 텍스트 범위 선택 (select_text_range)
• ✅ 찾기/바꾸기 (find_and_replace)
• ✅ 일반 텍스트 삽입 (insert_text)

완전한 서식 제어

• ✅ 글꼴 서식 적용 (apply_font_format)
• ✅ 문단 서식 설정 (set_paragraph_format)
• ✅ 페이지 여백 설정 (set_page_margins)
• ✅ 용지 크기 및 방향 설정 (set_page_size)

표 기능

• ✅ 표 생성 (create_table)
• ✅ 셀 병합 (merge_table_cells)

객체 삽입

• ✅ 이미지 삽입 (insert_image)
• ✅ 도형 삽입 (insert_shape)
• ✅ 하이퍼링크 삽입 (insert_hyperlink)

문서 구조 관리

• ✅ 머리글/바닥글 삽입 (insert_header_footer)
• ✅ 페이지 나누기 (insert_page_break)
• ✅ 목차 생성 (create_table_of_contents)
• ✅ 제목 스타일 적용 (apply_heading_style)

고급 기능

• ✅ PDF 내보내기 (export_to_pdf)
• ✅ 한글 초기화 (initialize_hwp)

📋 필수 요구사항

시스템 요구사항

• 운영체제: Windows (한글 프로그램 지원)
• Python: 3.10 이상
• 한글: 한글 2010 이상 (HWPFrame.HwpObject 지원)

필수 패키지

🛠️ 설치 및 설정

1. 패키지 설치

2. Claude Desktop 설정

Claude Desktop의 설정 파일에 다음 내용을 추가합니다:

Windows 설정 파일 위치: %APPDATA%\Claude\claude_desktop_config.json

3. 한글 프로그램 설치 확인

• 한글 프로그램이 설치되어 있어야 합니다
• COM 객체 등록이 정상적으로 되어 있어야 합니다

🎯 사용 방법

기본 사용법

Claude Desktop에서 다음과 같이 요청하면 됩니다:

고급 사용법

1. 서식이 적용된 문서 생성

2. 표가 포함된 문서

3. 이미지 삽입

4. 페이지 설정

📁 프로젝트 구조

🔧 문제해결

1. 한글 초기화 실패

• 한글 프로그램이 설치되어 있는지 확인
• 한글을 한 번 실행해서 정상 동작하는지 확인
• COM 객체 등록 확인

2. 패키지 설치 오류

• 관리자 권한으로 실행
• 가상환경 사용 권장

3. Claude Desktop 연결 실패

• 설정 파일 경로가 정확한지 확인
• Python 경로가 올바른지 확인
• 방화벽 설정 확인

📊 성능 지표

• 초기화 시간: < 3초
• 문서 생성 시간: < 2초
• 서식 적용 시간: < 1초
• 메모리 사용량: < 50MB

🚧 알려진 제한사항

1. Windows 전용: 한글 프로그램의 특성상 Windows에서만 동작
2. 한글 필수: 한글 프로그램이 설치되어 있어야 함
3. COM 의존성: Windows COM 객체에 의존

📈 향후 개선 계획

• 매크로 실행 기능 추가
• 차트 삽입 기능 추가
• 일괄 서식 적용 기능 강화
• 성능 최적화
• 오류 처리 개선

🤝 기여하기

이 프로젝트는 한국어 문서 작업의 자동화를 위한 프로젝트입니다. 기여, 피드백, 이슈 리포트를 환영합니다!

📄 라이선스

이 프로젝트는 MIT 라이선스 하에 배포됩니다.

참고: 이 MCP 서버는 기존의 기본 한글 MCP 서버 대비 10배 이상 많은 기능을 제공합니다.