{"repo":"treesoop/hwp-mcp","free":true,"listed":false,"github":"https://github.com/treesoop/hwp-mcp","clone":"git clone https://github.com/treesoop/hwp-mcp.git","description":"MCP server for reading and writing HWP/HWPX (Korean Hangul) documents — built on rhwp. 34 tools, Claude/Cursor/ChatGPT compatible.","language":"TypeScript","stars":73,"topics":["ai-agent","claude","cursor","hancom","hancom-office","hangul","hwp","hwpx","korean","llm"],"license":"MIT","category":"ai-agents","readme_excerpt":"hwp-mcp Claude · Cursor · ChatGPT 등 MCP 호환 AI에서 한글 문서(.hwp / .hwpx) 를 읽고 수정하고 새로 만들 수 있게 해주는 서버입니다. hwp-mcp 은 한컴오피스 문서를 AI 에이전트가 직접 다루도록 해주는 MCP(Model Context Protocol) 서버입니다. 읽기뿐 아니라 텍스트 수정, 템플릿 채우기, 새 문서 생성까지 가능합니다. 🍎 맥에서도 됩니다. 기존 HWP 자동화 도구 대부분은 한컴오피스 COM API 기반이라 Windows 전용이지만, hwp-mcp 는 WebAssembly 엔진이라 macOS(Apple Silicon 포함) · Windows · Linux 어디서든 한컴오피스 설치 없이 동작합니다. 어떤 프로젝트인가요? 이 프로젝트는 두 부분으로 나뉩니다. - 🔧 핵심 엔진: rhwp — Edward Kim 님의 rhwp 는 한글 포맷(HWP 5.0 binary, HWPX/OWPML)을 Rust + WebAssembly로 구현한 오픈소스 엔진입니다. 파싱, 표·이미지·수식·머리말 추출, SVG 렌더링, 한컴 호환 Field API 등 포맷 처리 능력을 제공합니다. - 🤝 hwp-mcp 가 한 일 (에이전트 어댑터) — @rhwp/core 위에 얹은 MCP 서버 layer. 우리가 추가한 것은: - read hwp , fill hwp template , replace hwp text 같은 에이전트 친화적 도구 시그니처 — Claude/Cursor 같은 LLM이 자연어로 호출할 수 있게 - 본문·표·이미지·머리말·꼬리말·각주·수식을 한 번에 dump 하는 시나리오 중심 traversal walker - 표 셀 병합 자동 처리, footnote/equation 자동 합본 같은 사용 편의 layer - rhwp 0.7.7 의 exportHwpx 라운드트립 한계를 우회하기 위한 .hwpx ZIP-level mutation layer (실제 쓰기를 가능하게 하는 핵심) - npm hwp-mcp 패키지 (한 줄 설치) + Node.js WASM 부트스트랩 요약: AI 에이전트가 한글 문서를 읽고 쓸 수 있게 해주는 어댑터 입니다. 포맷 처리는 rhwp, 에이전트 연동은 hwp-mcp 가 담당합니다. --- 설치 Claude Code Claude Desktop / Cursor / VS Code (settings JSON) Node.js 20 이상 필요. macOS · Windows · Linux 모두 지원 — 엔진이 WebAssembly 기반이라 한컴오피스 설치 없이 OS 무관하게 동작합니다. pywin32·COM 자동화처럼 Windows에 묶이지 않아 맥북에서도 위 한 줄로 끝 입니다. 설치 확인 ✓ Connected 가 뜨면 끝. 처음 써보기 (60초) 설치 직후 동작 확인용 가장 짧은 검증: 위 두 단계가 되면 읽기·쓰기 양쪽 다 동작합니다. 이제 실제 문서로: - /Downloads/공고문.hwp 읽어줘 - report.hwpx 의 {{이름}}을 남대현으로, {{날짜}}를 ","default_branch":null,"files":null,"tree":[],"storefront":"/r/treesoop","claimed":false,"request_supported":{"post":"https://gitbuyer.com/r/treesoop/hwp-mcp/request-supported","requests":0},"note":"indexed from public GitHub; nothing is for sale on this page. Clone it from GitHub. Paid listings live at /search."}