hwp-mcp는 HWP 문서를 다루는 MCP(Model Context Protocol) 서버입니다. Python으로 작성됐고 2025년 3월에 시작해 2026년 8월 기준 스타 265개·포크 64개를 기록 중입니다.
시점이 갖는 의미:
2025년 3월은 MCP가 공개된 지 얼마 안 된 시점입니다. 그 시기에 한국 개발자가 곧바로 “AI에게 한글 문서를 물리자”를 시도했다는 기록입니다. 이후 나온 여러 HWP MCP 서버(treesoop/hwp-mcp, hwpxskill, kordoc)들의 앞자리에 있는 초기 구현입니다.
AI에게 “이 보고서 요약해줘”를 시키려면 AI가 파일을 읽어야 합니다. PDF·DOCX는 대부분의 AI 도구가 기본 지원하지만 HWP는 아무도 지원하지 않습니다. MCP 서버 하나만 붙이면 그 격차가 바로 사라집니다. 투입 대비 효과가 큰 지점입니다.
포크 64개가 말해주는 것:
스타 265에 포크 64면 비율이 높은 편입니다. 문서 처리는 조직마다 양식과 요구가 달라서, 그대로 쓰기보다 가져다 고쳐 쓰는 경우가 많습니다. 그 흔적이 포크로 남습니다.
한국 HWP MCP 계보:
- 2025-03 hwp-mcp (jkf87) — 초기 구현
- 2026-02 hwpxskill (Canine89) — 서식 보존 편집에 집중
- 2026-03 kordoc (딴짓하는 류주임) — 파싱·비교·생성 종합
- 2026-03 treesoop/hwp-mcp — rhwp 기반, 34개 도구
1년 사이에 접근이 다른 구현이 여럿 나왔고, 뒤로 갈수록 “읽기”에서 “서식 보존 편집”으로 난이도가 올라갔습니다.
이 사례가 한국 1인 메이커 씬에 주는 의미:
새 기술이 나왔을 때 자기 나라 문제에 가장 먼저 붙여보는 사람들이 생태계의 출발선을 만듭니다. 완성도보다 시점이 기여인 경우가 있습니다.
같은 결의 한국 HWP·MCP 프로젝트 (우리 디스커버 등록):
- kordoc (문서 파싱·비교·생성 MCP)
- hwpxskill (AI 에이전트 HWPX 편집 스킬)
- hwp-mcp (treesoop · rhwp 기반)
- Awesome MCP Korea (한국 MCP 큐레이션)
정직하게 볼 지점:
초기 구현이라 지원 범위가 좁을 수 있습니다. 표·수식·개체가 많은 문서에서 실패하거나 원본과 다르게 저장될 수 있으므로 표본으로 먼저 확인해야 합니다.
그리고 AI가 문서를 직접 쓰는 구조는 덮어쓰기 사고로 이어질 수 있습니다. 작업 경로를 좁히고 원본을 복사해두고 쓰는 편이 안전합니다.
타겟 사용자:
- AI에게 한글 문서를 읽히고 싶은 실무자
- MCP 서버를 처음 만들어보려는 개발자
- 문서 자동화를 AI로 풀려는 1인 메이커
- 한국 MCP 생태계 초기 구현을 참고하려는 개발자
자주 묻는 질문
hwp-mcp (jkf87), 어떤 서비스인가요?
hwp-mcp는 HWP 문서를 다루는 MCP(Model Context Protocol) 서버입니다. Python으로 작성됐고 2025년 3월에 시작해 2026년 8월 기준 스타 265개·포크 64개를 기록 중입니다.
hwp-mcp (jkf87), 누가 만들었나요?
hwp-mcp는 HWP 문서를 다루는 MCP(Model Context Protocol) 서버입니다. 한국 인디 메이커 생태계의 한글문서 사례로 Dreamboat 디스커버에 수록돼 있습니다.
hwp-mcp (jkf87), 어떤 사람에게 추천되나요?
hwp-mcp (jkf87) — AI에게 한글 문서를 읽히고 싶은 실무자, MCP 서버를 처음 만들어보려는 개발자, 문서 자동화를 AI로 풀려는 1인 메이커, 한국 MCP 생태계 초기 구현을 참고하려는 개발자에게 맞습니다.
hwp-mcp (jkf87), 어디서 사용할 수 있나요?
hwp-mcp (jkf87) 공식 사이트는 github.com/jkf87/hwp-mcp 이며, 여기서 바로 이용할 수 있습니다. Dreamboat 디스커버에서는 이 서비스가 무엇이고 누구에게 맞는지, 비슷한 한국 인디 메이커 서비스는 무엇이 있는지 함께 정리해 두었습니다.
