hwp-mcp
MCP-сервер читает, правит и создает корейские документы HWP и HWPX без Hancom Office на macOS, Windows и Linux.
- 107 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Сервер читает и правит файлы документов на диске, запись возможна только в `.hwpx`.
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/hwp-mcpОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Сервер читает и правит файлы документов на диске, запись возможна только в `.hwpx`.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
hwp-mcp дает агенту работать с документами формата Hancom Office: `.hwp` и `.hwpx`. Читать и рендерить можно оба формата, писать только `.hwpx`. Версия 0.3 открывает 35 инструментов. Чтение выдает основной текст, таблицы в виде Markdown с обработкой объединенных ячеек, список изображений, колонтитулы, сноски и формулы. Рендер превращает страницы в SVG или HTML. На запись есть замена текста, заполнение шаблонов с метками вида `{{имя}}`, замена абзацев и ячеек таблиц, вставка и удаление изображений и создание нового `.hwpx` из текста. Движок на WebAssembly (проект rhwp) работает без COM-автоматизации Hancom Office, поэтому сервер запускается на macOS, Windows и Linux. Автор дописал слой для агентов и обход ограничения экспорта `.hwpx` на уровне ZIP.
Для кого. Тем, кто работает с корейскими официальными документами и поручает агенту читать, заполнять и править HWP и HWPX.
Подходит, если
- Текст из `.hwp` нужно прочитать вместе с таблицами, колонтитулами и сносками.
- Шаблон с метками `{{имя}}` заполняют данными из списка.
- В `.hwpx` заменяют строку по всему документу.
- На Mac нужно открыть документ без Hancom Office.
Не подходит, если
- Нужна запись в бинарный `.hwp`: он не поддерживается, сначала сохраните документ как `.hwpx` в Hancom Office.
- Требуется печать и точный макет страницы: рендер идет движком rhwp.
- Искомая строка разбита на два текстовых узла: замена ее не найдет.
Пример запроса к агенту
Прочитай report.hwpx вместе с таблицами и сносками, затем замени в нем строку 2025 на 2026 и сохрани копию.MCP
- Транспорт
- stdio
- Авторизация
- не нужна
Ограничения
Запись работает только для `.hwpx`: бинарный `.hwp` читается, но не пишется из-за ограничения обратной конвертации в rhwp 0.7.7. Откройте такой файл в Hancom Office и сохраните как `.hwpx`, затем применяйте инструменты записи. Замена не находит строку, которая разбита на два текстовых узла, как и в штатном hwpctl от Hancom. Вставка новых таблиц отмечена как экспериментальная: файл валиден, но движок распознает его не полностью. Нужен Node.js 20 и новее. Документация на корейском. Автор отмечает, что основную работу с форматом делает движок rhwp Эдварда Кима.
Как отключить. Удалите запись командой `claude mcp remove hwp-mcp` или уберите блок `hwp-mcp` из JSON-настроек клиента.
Частые вопросы
Как подключить hwp-mcp к Claude Code?
Выполните `claude mcp add hwp-mcp -- npx -y hwp-mcp`. Для Claude Desktop, Cursor и VS Code добавьте в MCP-настройки JSON с `npx` и аргументами `-y` и `hwp-mcp`.
Нужен ли Hancom Office?
Нет. Движок на WebAssembly работает на macOS, Windows и Linux без Hancom Office и без COM-автоматизации Windows.
Можно ли писать в файл .hwp?
Нет. Запись поддерживается только для `.hwpx`. Сохраните документ как `.hwpx` в Hancom Office и затем используйте инструменты записи.
Как проверить установку?
Командой `claude mcp list | grep hwp-mcp`: статус должен показать Connected. Затем попросите создать `hello.hwpx` с одной строкой.
Какие инструменты чтения есть?
`read_hwp` для текста, таблиц и списка изображений, `read_hwp_text` для текста с колонтитулами, сносками и формулами, `read_hwp_tables` для таблиц в Markdown.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыMCP-сервер и CLI для корейских документов HWPX: правка текста и таблиц, заполнение форм, создание документа по плану.
Скилл читает, создает и правит корейские документы hwp и hwpx прямо из агента, без Hancom Office и без конвертации
CLI и MCP-сервер переводят корейские HWP и HWPX, PDF и Office-файлы в Markdown и заполняют формы по шаблонам
Скилл создает и правит документы HWPX, конвертирует HWP, собирает официальные письма и отчеты по JSON-спецификации
Adeu: MCP, навык и CLI для правки .docx через агента с настоящими Track Changes, комментариями и сравнением версий.
MCP Word для правки документов docx с рецензированием: вставки и удаления видны в Word, комментарии, сноски, сравнение версий и журнал изменений
Коротко о README
Сервер оборачивает движок rhwp в MCP-инструменты, которые понятны ИИ-агентам, и добавляет запись в `.hwpx` через изменение ZIP-архива.