Related MCP Server Resources

Explore more AI models, providers, and integration options:

  • Explore AI Models
  • Explore AI Providers
  • Explore MCP Servers
  • LangDB Pricing
  • Documentation
  • AI Industry Blog
  • MongoDB MCP Server for LLMs
  • Notion MCP Server
  • Kintone MCP Server
  • Image Generation MCP Server
  • SQLite MCP Server
Back to MCP Servers
HWP MCP Server

HWP MCP Server

Public
jkf87/hwp-mcp

Enables AI models to create, edit, and manage Hangul (HWP) documents through Model Context Protocol, offering automated text editing, table manipulation, template-based document generation, and batch processing on Windows.

python
0 tools
May 30, 2025
Updated Jun 4, 2025

Supercharge Your AI with HWP MCP Server

MCP Server

Unlock the full potential of HWP MCP Server through LangDB's AI Gateway. Get enterprise-grade security, analytics, and seamless integration with zero configuration.

Unified API Access
Complete Tracing
Instant Setup
Get Started Now

Free tier available • No credit card required

Instant Setup
99.9% Uptime
10,000+Monthly Requests

HWP-MCP (한글 Model Context Protocol)

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

주요 기능

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

시스템 요구사항

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

설치 방법

  1. 저장소 클론:
git clone https://github.com/jkf87/hwp-mcp.git cd hwp-mcp
  1. 의존성 설치:
pip install -r requirements.txt
  1. (선택사항) MCP 패키지 설치:
pip install mcp

사용 방법

Claude와 함께 사용하기

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

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

주요 기능 예시

새 문서 생성

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": {"size": 20, "bold": True}}, {"operation": "hwp_save", "params": {"path": "경로/문서명.hwp"}} ])

프로젝트 구조

hwp-mcp/
├── hwp_mcp_stdio_server.py  # 메인 서버 스크립트
├── requirements.txt         # 의존성 패키지 목록
├── hwp-mcp-구조설명.md       # 프로젝트 구조 설명 문서
├── src/
│   ├── tools/
│   │   ├── hwp_controller.py  # 한글 제어 핵심 컨트롤러
│   │   └── hwp_table_tools.py # 테이블 관련 기능 전문 모듈
│   ├── utils/                 # 유틸리티 함수
│   └── __tests__/             # 테스트 모듈
└── security_module/
    └── FilePathCheckerModuleExample.dll  # 보안 모듈

트러블슈팅

보안 모듈 관련 문제

기본적으로 한글 프로그램은 외부에서 파일 접근 시 보안 경고를 표시합니다. 이를 우회하기 위해 FilePathCheckerModuleExample.dll 모듈을 사용합니다. 만약 보안 모듈 등록에 실패해도 기능은 작동하지만, 파일 열기/저장 시 보안 대화 상자가 표시될 수 있습니다.

한글 연결 실패

한글 프로그램이 실행 중이지 않을 경우 연결에 실패할 수 있습니다. 한글 프로그램이 설치되어 있고 정상 작동하는지 확인하세요.

테이블 데이터 입력 문제

테이블에 데이터를 입력할 때 커서 위치가 예상과 다르게 동작하는 경우가 있었으나, 현재 버전에서는 이 문제가 해결되었습니다. 테이블의 모든 셀에 정확하게 데이터가 입력됩니다.

변경 로그

2025-03-27

  • 표 생성 및 데이터 채우기 기능 개선
    • 표 안에 표가 중첩되는 문제 해결
    • 표 생성과 데이터 채우기 기능 분리
    • 표 생성 전 현재 커서 위치 확인 로직 추가
    • 기존 표에 데이터만 채우는 기능 개선
  • 프로젝트 관리 개선
    • .gitignore 파일 추가 (임시 파일, 캐시 파일 등 제외)

2025-03-25

  • 테이블 데이터 입력 기능 개선
    • 첫 번째 셀부터 정확하게 데이터 입력 가능
    • 셀 선택 및 커서 위치 설정 로직 개선
    • 텍스트 입력 시 커서 위치 유지 기능 추가
  • 테이블 전용 도구 모듈(hwp_table_tools.py) 추가
  • hwp_fill_column_numbers 함수에 from_first_cell 옵션 추가

라이선스

이 프로젝트는 MIT 라이선스에 따라 배포됩니다. 자세한 내용은 LICENSE 파일을 참조하세요.

기여 방법

  1. 이슈 제보 또는 기능 제안: GitHub 이슈를 사용하세요.
  2. 코드 기여: 변경사항을 포함한 Pull Request를 제출하세요.

관련 프로젝트

  • HWP SDK: 한글과컴퓨터의 공식 SDK
  • Cursor MCP
  • Smithery

연락처

프로젝트 관련 문의는 GitHub 이슈, 코난쌤를 통해 해주세요.

Publicly Shared Threads0

Discover shared experiences

Shared threads will appear here, showcasing real-world applications and insights from the community. Check back soon for updates!

Share your threads to help others
Related MCPs5
  • MongoDB MCP Server for LLMs
    MongoDB MCP Server for LLMs

    Enables LLMs to seamlessly interact with MongoDB databases via Model Context Protocol, offering sche...

    Added May 30, 2025
  • Notion MCP Server
    Notion MCP Server

    Enables AI models to seamlessly interact with Notion workspaces via the official SDK, offering compr...

    17 tools
    Added May 30, 2025
  • Kintone MCP Server
    Kintone MCP Server

    Enables seamless integration with kintone via Model Context Protocol, offering comprehensive capabil...

    25 tools
    Added May 30, 2025
  • Image Generation MCP Server
    Image Generation MCP Server

    Enables high-quality image generation via Model Context Protocol with customizable dimensions, promp...

    1 tools
    Added May 30, 2025
  • SQLite MCP Server
    SQLite MCP Server

    A Model Context Protocol server enabling AI models to execute SQL queries, manage SQLite database sc...

    Added May 30, 2025