kordoc MCP
CLI и MCP-сервер переводят корейские HWP и HWPX, PDF и Office-файлы в Markdown и заполняют формы по шаблонам
- 2 926 ★ репозитория
- Последний коммит
- MIT
Широкий доступ
Почему такой уровень
- Инструменты создают, конвертируют и правят файлы документов на диске
- Сервер читает любые файлы по переданному пути, если не задан `KORDOC_ROOT`
- Заполнение форм и штампы в документах влияют на официальные бумаги, результат нужно проверять
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/kordocОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Инструменты создают, конвертируют и правят файлы документов на диске
- Сервер читает любые файлы по переданному пути, если не задан `KORDOC_ROOT`
- Заполнение форм и штампы в документах влияют на официальные бумаги, результат нужно проверять
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
kordoc читает документы HWP 3.x и 5.x, HWPX, HWPML, PDF, XLS и XLSX, DOCX, PPTX и изображения и отдает Markdown или структурированные данные. Файлы HWP разбираются напрямую, установленный Hancom Office не нужен. Сканы проходят локальное OCR, оно включается флагом `--ocr`. kordoc работает как библиотека, как CLI (`npx kordoc документ.hwpx -o документ.md`) и как MCP-сервер. Команда `npx -y kordoc setup` регистрирует сервер во всех найденных клиентах: Claude Desktop, Claude Code, Cursor, Codex. После перезапуска клиента агенту доступны 22 инструмента для разбора, сравнения, создания, проверки и отрисовки документов. Кроме чтения есть запись: Markdown переводится в HWPX по шаблонам служебных документов, HWP конвертируется в HWPX, поля форм заполняются из JSON, документы сравниваются по блокам и ячейкам. Режим `--format chunks` режет документ на фрагменты для RAG, в режиме `KORDOC_OFFLINE=1` внешние запросы отключаются.
Для кого. Для разработчиков RAG-систем и автоматизации госслужбы в Корее и для всех, кому агент должен прочитать файл HWP или HWPX.
Подходит, если
- Агенту нужно прочитать файл HWP или HWPX, который не открывается без Hancom Office
- Нужно перевести корейские PDF и сканы в Markdown с сохранением таблиц и объединенных ячеек
- Нужно найти различия между двумя версиями документа по блокам и ячейкам
- Нужно заполнить формы или служебные записки в HWPX из данных JSON
- Нужно нарезать документы на фрагменты с путем заголовков для индекса RAG
Не подходит, если
- Документы только на русском или английском и в обычных PDF, DOCX: хватит MarkItDown
- Нужна визуально точная верстка HWPX как в Hancom: по бенчмаркам авторов позиция текста расходится
- Нужна стопроцентная точность распознавания сканов: OCR ошибается в структуре таблиц
Пример запроса к агенту
Прочитай файл отчет.hwpx, переведи его в Markdown и покажи таблицыMCP
- Транспорт
- stdio
- Авторизация
- не нужна
Переменные окружения
KORDOC_OFFLINE- Значение 1 блокирует все внешние запросы, OCR идет локально
KORDOC_ROOT- Ограничивает папки, к которым имеет доступ MCP-сервер
Ограничения
Нужен Node.js 20 или новее. Зависимости PDF и OCR ставятся по умолчанию, при установке с `--omit=optional` эти функции ограничены. Основная документация и интерфейс на корейском, есть английский README. Формат HWP 5.x конвертируется в HWPX с сохранением оформления, для остальных форматов точность разная: на OCR-наборе структура таблиц совпала в 34 из 66 случаев. Часть оценок качества авторы получили на собственных наборах документов.
Как отключить. Удалите запись `kordoc` из конфигурации MCP вашего клиента и перезапустите его. Плагин Claude Code удалите через менеджер плагинов `/plugin`.
Частые вопросы
Как открыть HWP-файл без Hancom Office?
Выполните `npx kordoc документ.hwp -o документ.md`: kordoc читает HWP напрямую и сохраняет результат в Markdown. Несколько файлов обрабатываются сразу командой `npx kordoc *.hwpx -d ./output`.
Как подключить kordoc к Claude Code?
Выполните `npx -y kordoc setup`, и MCP-сервер появится во всех найденных клиентах, включая Claude Code. Второй путь — плагин: `/plugin marketplace add chrisryugj/kordoc`, затем `/plugin install kordoc@kordoc`.
Работает ли kordoc без интернета?
Да, с переменной `KORDOC_OFFLINE=1` внешние запросы блокируются, а OCR идет на локальном процессоре без API-ключа. Инструкция для закрытых сетей лежит в `docs/offline-deployment.md`.
Можно ли использовать kordoc для RAG?
Да. Флаг `--format chunks` выдает структурные фрагменты с путем заголовков и отдельные фрагменты для таблиц. Таблицы без HTML дает `--table-format gfm`.
Есть ли у kordoc SDK для других языков?
Да, в репозитории есть SDK для Python и Java.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыСкилл читает, создает и правит корейские документы hwp и hwpx прямо из агента, без Hancom Office и без конвертации
Скилл создает и правит документы HWPX, конвертирует HWP, собирает официальные письма и отчеты по JSON-спецификации
MCP-сервер на базе pandoc: агент конвертирует Markdown, HTML, DOCX, LaTeX, EPUB, ODT и другие форматы друг в друга
Doc-Ops MCP конвертирует DOCX, Markdown, HTML и PDF между собой и ставит водяной знак или QR-код на готовые PDF.
Docling — CLI для смешанного архива: PDF, документы и таблицы можно привести к общему формату для поиска и ИИ.
Утилита Microsoft и MCP-сервер, которые переводят PDF, Word, Excel, PowerPoint, HTML и другие файлы в Markdown для модели
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| kordoc (эта карточка) | нет | не нужна | 2 926 | |
| MarkItDown | да | не нужна | 194 015 | конвертирует общие форматы Office и PDF, но не читает HWP |
| claw-hwp | нет | 218 | скилл для чтения и правки HWP и HWPX без отдельного MCP-сервера | |
| Docling MCP | да | не нужна | 786 | разбирает PDF и создает документы на движке Docling |
Коротко о README
Автор, сотрудник районной администрации в Сеуле, собрал инструмент после семи лет работы с файлами HWP. Репозиторий включает библиотеку, CLI, MCP-сервер, SDK для Python и Java, плагин Claude Code и скилл для служебных документов. Там же лежат результаты тестов на публичных и собственных наборах и журнал версий.