스프쌤
스레드

한컴2024, 윈도우 실시간 편집가능한 mcp 곻유 (rhwp 아님)

✍ @_ino_design_⏱ 8분 소요2026-09-06👁
← 목록으로 돌아가기

한/글 문서를 닫지 않은 채로 AI 에이전트가 그 문서를 읽고 고치게 할 수 있을까요? GSG HWP는 이 질문에 로컬 MCP로 답하는 도구입니다.

✦ AI Key Summary & Global Takeaways

이 아티클의 핵심 내용 요약과 글로벌 검색·AI 엔진을 위한 테이크어웨이입니다.

✦ KR 주제: 한컴2024·Windows 한/글 문서를 실시간으로 다루는 로컬 MCP, GSG HWP

✦ KR 핵심 요약: GSG HWP는 Codex나 Claude Code 같은 에이전트 앱이 Windows 한/글에서 열려 있는 HWP 문서를 빠르게 조회하고 네이티브 방식으로 편집·검수하도록 연결하는 로컬 MCP입니다. 배포 버전 v1.7.0은 서식 제어, 검증 기반 일괄 수정, 병합 표 구조 검증, Excel 행 읽기와 표 크기 고정 등을 개선했고, 공개 도구는 총 79개로 안내됩니다.

🌐 Global Takeaway: GSG HWP is a local MCP that lets agent apps query and natively edit HWP documents currently open in Windows Hangul. Its v1.7.0 release focuses on safer formatting control and verification-based batch edits, with all figures tracked in a compatibility manifest.

한컴오피스 한/글에서 문서를 열어 둔 상태로, 그 문서를 AI 에이전트가 직접 읽고 고치게 하는 구성은 생각보다 까다롭습니다. 파일을 복사해 파싱하는 방식은 서식이 깨지기 쉽고, 저장 전 문서를 다루기는 더 어렵습니다. 이번에 살펴볼 GSG HWP는 이 지점을 "현재 열려 있는 문서에 붙는 로컬 MCP"로 접근한 사례입니다.

한컴 문서와 에이전트를 잇는 로컬 MCP

README 설명에 따르면 GSG HWP는 Codex, Claude Code 같은 에이전트 앱이 Windows 한/글에서 현재 열려 있는 HWP 문서를 빠르게 조회하고 네이티브 방식으로 편집·검수하도록 연결하는 로컬 MCP입니다. 별도 뷰어나 변환 서버를 새로 세우기보다, 한/글이라는 실제 편집 환경을 그대로 둔 채 그 위에서 작업하는 구조를 지향한다는 뜻입니다.

저장소 구성도 이런 성격을 그대로 보여줍니다. plugins/gsg-hwp 아래에 플러그인이 자리하고, 루트에는 .mcp.json, AGENTS.md, CLAUDE.md, CHANGELOG.md, QUICKSTART-KO.md, 그리고 설치·복구·제거용 PowerShell 스크립트(install.ps1, restore-update.ps1, uninstall.ps1)가 함께 있습니다. 설치와 자동 업데이트, 복구, 제거를 각각 스크립트로 분리해 둔 점은 실무에서 특히 눈에 띄는 부분입니다. 테스트 디렉터리와 GitHub 워크플로까지 포함되어 있어, 개인 실험이라기보다 배포를 전제로 관리되는 저장소로 보입니다.

"rhwp 아님"이라는 단서

원문 제목에는 "rhwp 아님"이라는 단서가 붙어 있습니다. 다만 확인되는 근거에는 rhwp의 기능이나 두 도구의 차이를 설명하는 내용이 없습니다. 확인 가능한 범위에서 이 도구의 정체성은 "한/글 네이티브 브리지를 통한 로컬 MCP"라는 쪽에 있습니다.

버전과 구성 요소

README에 표기된 수치는 아래와 같습니다. 이 값들은 plugins/gsg-hwp/compatibility-manifest.json을 기준으로 릴리스마다 갱신되며, 버전별 변경 사항은 CHANGELOG.md에 기록된다고 명시되어 있습니다.

항목 표기 값
배포 버전 v1.7.0
원본 소스 버전 0.5.73-dev.3
MCP 런타임 0.3.91
C++ 네이티브 브리지 0.5.180
네이티브 프로토콜 14
그래프 전송 프로토콜 15
공개 도구 업무 도구 78개 + 런타임 재로드 1개 = 79개
공식 API 카탈로그 1,452개 중 네이티브 라우팅 1,448개

도구 개수를 막연히 "많다"고 적지 않고 매니페스트 값으로 못 박아 두었다는 점, 그리고 배포 버전과 소스 버전, 런타임, 브리지, 프로토콜을 각각 따로 표기한다는 점이 이 저장소의 특징입니다. 에이전트 도구는 구성 요소 간 버전이 어긋나면 동작이 달라지기 때문에, 이렇게 층을 나눠 표기하는 방식이 문제 파악에 도움이 됩니다.

v1.7.0에서 달라진 편집 기능

v1.7.0의 주요 변경으로 안내된 항목은 문서 편집의 결을 다루는 것들입니다. 글자 자간, 문단 여백, 내어쓰기, 다음 문단과 함께, 쪽 나눔 설정을 지원하고, 기존 제목의 문단·글자 모양을 복사해 자동번호를 보존합니다. 검색 팝업 없이 텍스트를 찾고, 확인된 문단의 원문과 실제 문자 위치를 검증한 뒤 일괄 수정하는 흐름도 포함됩니다. 병합된 표는 실제 셀 구조에 맞춰 선택 범위를 검증하고, 테두리 적용과 사진 표 재구성 시 내용 보존을 개선했습니다. 새 도구로는 Excel 행을 한 번에 읽는 hwp_read_workbook_rows와 표의 크기 고정을 설정하는 hwp_set_table_size_fixed가 추가되었습니다.

이 목록의 공통점은 "글자를 바꾸는 일"보다 "바꾼 뒤에도 문서가 무너지지 않게 하는 일"에 초점이 있다는 것입니다. 병합 표의 셀 구조 검증이나 사진 표 재구성 시 내용 보존처럼, 자동화가 가장 자주 사고를 내는 지점을 건드리고 있습니다.

배포 범위와 신뢰성에 대한 메모

README는 배포본에 대해 분명하게 선을 긋습니다.

배포에는 제품 소스와 필수 실행 파일만 포함합니다. 개인 문서·사진·로그·작업 산출물·개발 테스트 자료는 포함하지 않습니다.

앞선 v1.6.2 변경도 같은 결입니다. 배포본 문서와 스크립트 출력의 사실 주장을 전수 정정하고, 도구 수·버전 표기·설치가 바꾸는 경로·자동 업데이트 순서·제거 스크립트가 실제로 지우는 범위처럼 확인 가능한 문장을 매니페스트와 스크립트 구현에 하나씩 맞췄다고 기록되어 있습니다. 안내 문서에 박아 두던 버전 문자열을 없앤 것도 같은 맥락입니다. 기능 소개보다 "문서에 쓴 문장과 실제 동작의 일치"를 먼저 손본 릴리스였다는 점이 인상적입니다.

실무 적용 포인트

첫째, 이 도구는 Windows 한/글 환경을 전제로 합니다. 따라서 도입 검토의 출발점은 기능 목록이 아니라 실행 환경과 한/글 설치 상태입니다. 원문 제목은 한컴2024를 언급하지만, 저장소 설명은 "Windows 한/글"로 표기하고 있으므로 실제 적용 전 자신의 버전에서 조회·편집이 정상 동작하는지 먼저 확인하는 편이 안전합니다.

둘째, 설치 전에 스크립트가 바꾸는 경로와 제거 시 지워지는 범위를 읽어 두는 것이 좋습니다. 저장소가 설치·복구·제거 스크립트를 분리해 제공하고, 변경 이력에서 이 범위를 실제 구현과 맞추는 작업을 별도로 언급하고 있기 때문입니다. 자동 업데이트 순서까지 문서화되어 있으니, 조직 내 배포라면 이 순서를 그대로 따르는 편이 예측 가능합니다.

셋째, 반복 편집 작업을 먼저 골라 시험하는 방식이 효율적입니다. 표 크기 고정, 병합 표 범위 검증, 문단 서식 복사를 통한 자동번호 보존처럼 결과를 눈으로 확인하기 쉬운 작업부터 적용하고, 문제가 없을 때 일괄 수정으로 범위를 넓히는 접근이 현실적입니다.

넷째, 버전 확인을 습관으로 두는 것이 좋습니다. 이 저장소는 compatibility-manifest.json을 기준으로 수치를 갱신한다고 밝히고 있으므로, 도입 시점의 배포 버전과 런타임·브리지·프로토콜 값을 함께 기록해 두면 이후 변경 이력을 해석하기 쉬워집니다.

핵심 정리

  • GSG HWP는 Windows 한/글에서 현재 열려 있는 HWP 문서를 에이전트 앱이 조회·편집·검수하도록 연결하는 로컬 MCP입니다.
  • 배포 버전은 v1.7.0이며, 공개 도구는 업무 도구 78개와 런타임 재로드 1개를 합한 79개로 안내됩니다.
  • v1.7.0은 자간·문단 여백·내어쓰기 같은 서식 제어, 검증 후 일괄 수정, 병합 표 구조 검증, Excel 행 읽기와 표 크기 고정 도구를 중심으로 개선되었습니다.
  • 수치는 compatibility-manifest.json, 변경 이력은 CHANGELOG.md를 기준으로 관리된다고 명시되어 있어, 도입 전 두 파일을 확인하는 것이 좋습니다.
스레드 첨부 이미지
원본 스레드 첨부 이미지
스레드 첨부 이미지
원본 스레드 첨부 이미지
스레드 첨부 이미지
원본 스레드 첨부 이미지

자주 묻는 질문

Q. GSG HWP는 어떤 환경에서 동작하나요?
A. 저장소 설명 기준으로 Windows 한/글에서 현재 열려 있는 HWP 문서를 대상으로 하는 로컬 MCP입니다. Codex, Claude Code 같은 에이전트 앱과 연결해 조회·편집·검수에 활용하는 구조이므로, 도입 전 자신의 한/글 버전에서 동작을 확인하는 것이 좋습니다.

Q. 공개 도구는 몇 개인가요?
A. README에는 업무 도구 78개와 런타임 재로드 1개를 합해 총 79개로 표기되어 있습니다. 이 수치는 plugins/gsg-hwp/compatibility-manifest.json을 기준으로 릴리스마다 갱신된다고 안내됩니다.

Q. v1.7.0에서 중점적으로 바뀐 부분은 무엇인가요?
A. 글자 자간과 문단 여백·내어쓰기·다음 문단과 함께·쪽 나눔 설정 지원, 기존 제목 서식을 복사해 자동번호를 보존하는 처리, 검색 팝업 없이 원문과 문자 위치를 검증한 뒤 일괄 수정하는 흐름, 병합 표의 실제 셀 구조에 맞춘 선택 범위 검증 등이 안내되어 있습니다. Excel 행을 한 번에 읽는 도구와 표 크기 고정 도구도 추가되었습니다.

원본

https://www.threads.com/@_ino_design_/post/DbDTKf3CU54

https://github.com/innae1121-bit/gsghwp

함께 보면 좋은 글

댓글 0개