Skip to content
Back to search

hwp-mcp

mcp for handling hwp

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/jkf87--hwp-mcp/badge.svg)](/listings/jkf87--hwp-mcp)

HTML

<a href="/listings/jkf87--hwp-mcp"><img src="/api/listings/jkf87--hwp-mcp/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

1. 저장소 클론:

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

2. 의존성 설치:

pip install -r requirements.txt

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

pip install "mcp<2"

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 175 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. [![MseeP.ai Security Assessment Badge](https://mseep.net/pr/jkf87-hwp-mcp-badge.png)](https://mseep.ai/app/jkf87-hwp-mcp)
  2. # HWP-MCP (한글 Model Context Protocol)
  3. [![GitHub](https://img.shields.io/github/license/jkf87/hwp-mcp)](https://github.com/jkf87/hwp-mcp)
  4. HWP-MCP는 한글 워드 프로세서(HWP)를 Claude와 같은 AI 모델이 제어할 수 있도록 해주는 Model Context Protocol(MCP) 서버입니다. 이 프로젝트는 한글 문서를 자동으로 생성, 편집, 조작하는 기능을 AI에게 제공합니다.
  5. ## 주요 기능
  6. - 문서 생성 및 관리: 새 문서 생성, 열기, 저장 기능
  7. - 텍스트 편집: 텍스트 삽입, 글꼴 설정, 단락 추가
  8. - 테이블 작업: 테이블 생성, 데이터 채우기, 셀 내용 설정
  9. - 완성된 문서 생성: 템플릿 기반 보고서 및 편지 자동 생성
  10. - 일괄 작업: 여러 작업을 한 번에 실행하는 배치 기능
  11. ## 시스템 요구사항
  12. - Windows 운영체제
  13. - 한글(HWP) 프로그램 설치
  14. - Python 3.10 이상 (`mcp` 패키지 요구사항)
  15. - 필수 Python 패키지 (requirements.txt 참조)
  16. > macOS/Linux 또는 한글이 설치되지 않은 환경에서도 서버는 실행되며, 이 경우 `hwp_read_file`(HWP 파일 읽기)만 사용할 수 있습니다.
  17. ## 설치 방법
  18. 1. 저장소 클론:
  19. ```bash
  20. git clone https://github.com/jkf87/hwp-mcp.git
  21. cd hwp-mcp
  22. ```
  23. 2. 의존성 설치:
  24. ```bash
  25. pip install -r requirements.txt
  26. ```
  27. 3. (선택사항) MCP 패키지 설치:
  28. ```bash
  29. pip install "mcp<2"
  30. ```
  31. ## 사용 방법
  32. ### Claude와 함께 사용하기
  33. Claude 데스크톱 설정 파일에 다음과 같이 HWP-MCP 서버를 등록하세요:
  34. ```json
  35. {
  36. "mcpServers": {
  37. "hwp": {
  38. "command": "python",
  39. "args": ["경로/hwp-mcp/hwp_mcp_stdio_server.py"]
  40. }
  41. }
  42. }
  43. ```
  44. ### 주요 기능 예시
  45. #### HWP 파일 읽기 (한글 프로그램 불필요, 모든 OS)
  46. ```python
  47. hwp_read_file("경로/문서.hwp") # 본문 텍스트 반환, 표는 Markdown 표로 변환
  48. ```
  49. #### 새 문서 생성
  50. ```python
  51. hwp_create()
  52. ```
  53. #### 텍스트 삽입
  54. ```python
  55. hwp_insert_text("원하는 텍스트를 입력하세요.")
  56. ```
  57. #### 테이블 생성 및 데이터 입력
  58. ```python
  59. # 테이블 생성
  60. hwp_insert_table(rows=5, cols=2)
  61. # 테이블에 데이터 채우기
  62. hwp_fill_table_with_data([
  63. ["월", "판매량"],
  64. ["1월", "120"],
  65. ["2월", "150"],
  66. ["3월", "180"],
  67. ["4월", "200"]
  68. ], has_header=True)
  69. # 표에 연속된 숫자 채우기
  70. hwp_fill_column_numbers(start=1, end=10, column=1, from_first_cell=True)
  71. ```
  72. #### 문서 저장
  73. ```python
  74. hwp_save("경로/문서명.hwp")
  75. ```
  76. #### 일괄 작업 예시
  77. ```python
  78. hwp_batch_operations([
  79. {"operation": "hwp_create"},
  80. {"operation": "hwp_insert_text", "params": {"text": "제목"}},
  81. {"operation": "hwp_set_font", "params": {"size": 20, "bold": True}},
  82. {"operation": "hwp_save", "params": {"path": "경로/문서명.hwp"}}
  83. ])
  84. ```
  85. ## 프로젝트 구조
  86. ```
  87. hwp-mcp/
  88. ├── hwp_mcp_stdio_server.py # 메인 서버 스크립트
  89. ├── requirements.txt # 의존성 패키지 목록
  90. ├── hwp-mcp-구조설명.md # 프로젝트 구조 설명 문서
  91. ├── src/
  92. │ ├── tools/
  93. │ │ ├── hwp_controller.py # 한글 제어 핵심 컨트롤러
  94. │ │ └── hwp_table_tools.py # 테이블 관련 기능 전문 모듈
  95. │ ├── utils/ # 유틸리티 함수
  96. │ └── __tests__/ # 테스트 모듈
  97. └── security_module/
  98. └── FilePathCheckerModuleExample.dll # 보안 모듈
  99. ```
  100. ## 트러블슈팅
  101. ### 보안 모듈 관련 문제
  102. 기본적으로 한글 프로그램은 외부에서 파일 접근 시 보안 경고를 표시합니다. 이를 우회하기 위해 `FilePathCheckerModuleExample.dll` 모듈을 사용합니다. 만약 보안 모듈 등록에 실패해도 기능은 작동하지만, 파일 열기/저장 시 보안 대화 상자가 표시될 수 있습니다.
  103. ### 한글 연결 실패
  104. 한글 프로그램이 실행 중이지 않을 경우 연결에 실패할 수 있습니다. 한글 프로그램이 설치되어 있고 정상 작동하는지 확인하세요.
  105. ### 테이블 데이터 입력 문제
  106. 테이블에 데이터를 입력할 때 커서 위치가 예상과 다르게 동작하는 경우가 있었으나, 현재 버전에서는 이 문제가 해결되었습니다. 테이블의 모든 셀에 정확하게 데이터가 입력됩니다.
  107. ## 변경 로그
  108. ### 2025-03-27
  109. - 표 생성 및 데이터 채우기 기능 개선
  110. - 표 안에 표가 중첩되는 문제 해결
  111. - 표 생성과 데이터 채우기 기능 분리
  112. - 표 생성 전 현재 커서 위치 확인 로직 추가
  113. - 기존 표에 데이터만 채우는 기능 개선
  114. - 프로젝트 관리 개선
  115. - .gitignore 파일 추가 (임시 파일, 캐시 파일 등 제외)
  116. ### 2025-03-25
  117. - 테이블 데이터 입력 기능 개선
  118. - 첫 번째 셀부터 정확하게 데이터 입력 가능
  119. - 셀 선택 및 커서 위치 설정 로직 개선
  120. - 텍스트 입력 시 커서 위치 유지 기능 추가
  121. - 테이블 전용 도구 모듈(`hwp_table_tools.py`) 추가
  122. - `hwp_fill_column_numbers` 함수에 `from_first_cell` 옵션 추가
  123. ## 라이선스
  124. 이 프로젝트는 MIT 라이선스에 따라 배포됩니다. 자세한 내용은 [LICENSE](LICENSE) 파일을 참조하세요.
  125. ## 기여 방법
  126. 1. 이슈 제보 또는 기능 제안: GitHub 이슈를 사용하세요.
  127. 2. 코드 기여: 변경사항을 포함한 Pull Request를 제출하세요.
  128. ## 관련 프로젝트
  129. - [HWP SDK](https://www.hancom.com/product/sdk): 한글과컴퓨터의 공식 SDK
  130. - [Cursor MCP](https://docs.cursor.com/context/model-context-protocol#configuration-locations)
  131. - [Smithery](https://smithery.ai/server/@jkf87/hwp-mcp)
  132. ## 연락처
  133. 프로젝트 관련 문의는 GitHub 이슈, [코난쌤](https://www.youtube.com/@conanssam)를 통해 해주세요.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.