hwp-mcp 설치 안내
=================

이 zip은 한글문서(.hwp/.hwpx)를 AI 도구에서 읽고 편집하기 위한 hwp 스킬과 kordoc MCP 설정을 담고 있습니다.

설치 파일 선택
--------------
- Claude Code를 쓰면: 설치_클로드.cmd
- Codex를 쓰면: 설치_코덱스.cmd
- Google Antigravity를 쓰면: 설치_안티그래비티.cmd

설치 방법
---------
1. zip 파일을 압축 해제합니다.
2. 사용하는 도구에 맞는 설치 파일을 더블클릭합니다.
   - Codex: 설치_코덱스.cmd
   - Claude Code: 설치_클로드.cmd
   - Google Antigravity: 설치_안티그래비티.cmd
3. 설치가 끝나면 해당 도구를 재시작하고 MCP 도구가 연결되었는지 확인합니다.
   - Codex: `codex mcp list` 또는 Codex 터미널의 `/mcp`
   - Claude Code: `claude mcp list` 또는 Claude Code의 `/mcp`
   - Antigravity: Settings > Customizations > Installed MCP Servers

관리자 권한 안내
---------------
Node.js가 이미 설치되어 있으면 관리자 권한이 필요하지 않습니다.
Node.js가 없을 때만 Windows가 관리자 권한을 요청할 수 있습니다.
다른 관리자 계정으로 권한 상승해야 하는 PC라면, 먼저 Node.js LTS를 설치한 뒤 일반 사용자 계정에서 설치 파일을 다시 실행하세요.

설치_클로드.cmd 가 하는 일
-------------------------
- Node.js와 npx가 있는지 확인합니다.
- Node.js가 없으면 winget으로 Node.js LTS 설치를 시도합니다.
- hwp 스킬을 현재 Claude Code 개인 스킬 위치(~\.claude\skills\hwp)에 설치합니다.
- Claude Code prompt hook을 설치합니다.
- Claude Code 전역 MCP 설정(~\.claude.json)에 kordoc 서버를 추가합니다.
- 기존의 잘못된 kordoc 설정(args = ["-y", "kordoc-mcp"] 등)을 백업 후 정리합니다.

설치_코덱스.cmd 가 하는 일
-------------------------
- Node.js와 npx가 있는지 확인합니다.
- Node.js가 없으면 winget으로 Node.js LTS 설치를 시도합니다.
- hwp 스킬을 현재 Codex 사용자 스킬 위치(~\.agents\skills\hwp)에 설치합니다.
- Codex MCP 설정(~\.codex\config.toml)에 kordoc 서버를 추가합니다.
- 기존의 잘못된 kordoc 설정(args = ["-y", "kordoc-mcp"] 등)을 백업 후 정리합니다.
- 기존 config.toml은 UTF-8로 읽고 UTF-8(BOM 없음)으로 다시 써서 한글 설정을 보존합니다.

설치_안티그래비티.cmd 가 하는 일
-------------------------------
- Node.js와 npx가 있는지 확인합니다.
- Node.js가 없으면 winget으로 Node.js LTS 설치를 시도합니다.
- hwp-mcp 플러그인을 %USERPROFILE%\.gemini\config\plugins\hwp-mcp 에 설치합니다.
- 플러그인의 mcp_config.json과 skills를 함께 설치합니다. Antigravity 2.0이 이 플러그인을 자동으로 검색합니다.

사용되는 MCP 명령
-----------------
세 설치 파일 모두 전역 설치 없이 아래 명령 형태를 사용합니다.

command = "cmd.exe"
args = ["/d", "/c", "npx", "-y", "--package", "kordoc", "kordoc-mcp"]

참고
----
kordoc은 npm 패키지 이름이고, kordoc-mcp는 그 패키지가 제공하는 실행 파일입니다.
따라서 처음 설치하는 PC에서는 npx -y --package kordoc kordoc-mcp 형태가 가장 안전합니다.

저작권 및 오픈소스 표기
----------------------
이 zip에 포함된 hwp 스킬, 설치 스크립트, 배포용 안내 문서는 공개 HWP/HWPX 포맷 문서를 바탕으로 별도 제작한 자체 제작물입니다.

- hwp 스킬/설치 패키지: Copyright (c) 2026 차형준. All rights reserved unless separately licensed.
- kordoc: Copyright (c) 2026 chrisryugj, MIT License.
  GitHub: https://github.com/chrisryugj/kordoc
- rhwp: Copyright (c) 2025-2026 Edward Kim, MIT License.
  GitHub: https://github.com/edwardkim/rhwp

설치 파일은 kordoc을 npx로 실행하도록 설정합니다. kordoc/rhwp의 원본 소스코드는 이 zip에 포함되어 있지 않으며, 각 프로젝트의 저작권과 라이선스는 위 원저작자에게 있습니다.
