# hwp-mcp (treesoop · rhwp 기반)

> HWP 편집 MCP 서버. rhwp 파서 위에 올린 HWP/HWPX 읽기·쓰기 서버로, 오픈소스 파서를 재사용해 34개 도구로 확장한 사례입니다.

- 페이지: https://dreamboat.kr/discover/hwp-mcp-treesoop
- 공식 사이트: https://github.com/treesoop/hwp-mcp
- 분야: 문서, AI
- 쓰는 환경: 챗봇·MCP
- 상태: 운영 중
- 등재: 2026-08-10 · 마지막 갱신: 2026-10-23


## 소개

treesoop의 hwp-mcp는 HWP/HWPX 문서를 읽고 쓰는 MCP 서버입니다. **rhwp 파서 위에 구축**됐다는 점이 특징이며, TypeScript로 작성됐습니다. 2026년 3월 시작해 2026년 8월 기준 스타 67개·포크 9개를 기록 중입니다.

오픈소스 재사용의 사례:
rhwp는 Rust·WASM으로 만든 HWP 뷰어·에디터(스타 3,652)이고, treesoop은 그 파서를 가져다 MCP 서버로 감쌌습니다. 파서를 처음부터 만들지 않고 이미 검증된 구현 위에 얹은 것으로, 오픈소스 생태계가 실제로 작동하는 방식을 보여줍니다.

이 구조의 장점:
- 파서 정확도는 rhwp 커뮤니티가 계속 개선 → 자동으로 혜택
- MCP 계층 설계에만 집중 가능
- 만드는 데 걸리는 시간이 크게 단축
- 중복 작업 회피

레이어드 접근이 인디 메이커에게 갖는 의미:
1인 메이커가 파일 포맷 파서를 처음부터 만드는 건 몇 달짜리 일입니다. 하지만 남이 만든 파서 위에 자기 계층을 올리면 며칠 만에 쓸 만한 제품이 나옵니다. “무엇을 직접 만들고 무엇을 가져다 쓸지”를 잘 나누는 것이 1인 개발의 핵심 역량입니다.

같은 이름, 다른 프로젝트:
jkf87의 hwp-mcp(Python, 2025-03 시작, 스타 265)와 이름이 같지만 별개 프로젝트입니다. 같은 문제를 다른 시점·다른 스택으로 푼 두 구현이 공존하는 상황이고, HWP MCP 수요가 그만큼 크다는 방증이기도 합니다.

기반과 응용이 나뉘기 시작했다:
생태계가 성숙하면 “기반을 만드는 사람”과 “그 위에 제품을 만드는 사람”이 분화됩니다. 한국 HWP 영역에서 그 분화가 실제로 일어나고 있다는 신호입니다. rhwp가 기반이 되고 여러 응용이 그 위에 쌓이는 구조는 건강한 오픈소스 생태계의 모습입니다.

같은 결의 한국 HWP·MCP 프로젝트:
- rhwp (기반 파서·뷰어)
- hwp-mcp (jkf87 · Python 초기 구현)
- hwpxskill (서식 보존 편집 스킬)
- kordoc (파싱·비교·생성 종합)

그리고 MCP로 노출하면 **에이전트가 파일을 만들고 고칩니다.** 어떤 경로에 쓸 수 있는지 범위를 좁혀두지 않으면 의도치 않은 덮어쓰기가 생길 수 있습니다.

타겟 사용자:
- AI에 한글 문서 읽기·쓰기를 붙이려는 개발자
- 오픈소스 위에 레이어를 올리는 방식을 참고하려는 메이커
- TypeScript로 MCP 서버를 만들려는 개발자
- HWP MCP 구현을 비교 검토하는 팀

## 인용

이 소개는 Dreamboat(드림보트)이 공식 사이트를 직접 확인해 작성했습니다.
출처(https://dreamboat.kr/discover/hwp-mcp-treesoop)를 명시하면 인용 가능합니다. 서비스 자체의 권리는 각 제작자에게 있습니다.
전체 목록: https://dreamboat.kr/llms.txt · 전문: https://dreamboat.kr/llms-full.txt