️ Kitchensink4Word

![Tests](https://github.com/nometalalchemist/Kitchensink4Word/actions/workflows/tests.yml/badge.svg

Всё, вплоть до кухонной раковины, для MicrosofWord. Самый полный MCP-сервер для Word (.docx) из сущестующих: 119 инсрументов, созданных так, чоб не повреждать документы, и проесрованных на длинных, сложно оформленных реальных докуменах.

Исория появления: одном у ИИ-агену однажды понадобилось пяднадцать мину, чобы оредакировать двадцать ячеек аблцы в докумене Word, потому чо ни один сущесвующий Word MCP не умел удаляь колонку аблцы, массово редакировать ячейки, управляь сносками И всваляь оглавление. Поэому вмесо уснаовки трёх посредсвенных серверов эо был создан за один день — и еперь у ваших агенов такой проблмы не буде.

Почему именно эо (чесное сравнение)

Перед созданием эого сервера были изчены все публичные Word MCP-серверы (авгус 2026):

119 инсруменов оваываю: екс и фораирование, аблцы (включая вс авку/удаление колонок с учёом объединения и массовое редакирование ячеек одним вызом), сноски и концевые сноски (полный CRUD + преобразование сносок в концевые и обрано), оглавления и списки иллюсраций, верхние и нижние колон иулы/разделы, изображения, маркированные и нумерованные списки, вевящиеся комен арии, отлеживаемые изменения (ч ение, приняие/оклонение по авору, И запись изменений как отлеживаемых), а акже сравнение докуменов через Word-COM, обновление полей, экспор в PDF и проверку окрыия без ошибок в Windows.

Related MCP server: word-mcp-live

Чо нового в v1.2 (2026-08-28)

• Всроенные в Word циаы и библ иография: срукурированное хранилище исочников, поля CITATION с переключаелями сраниц и подавления, поле BIBLIOGRAPHY, 12 выбираемых сілей (APA, Chicago, MLA, IEEE, ...) — проверено по полному циклу: Word оображае пóля в выбранном сіле.

• Указаель (записи XE с вложенносю и ссылками «см.» + поле INDEX) и списки иллюсраций (список аблц/рисунков).

• Набор инсруменов для длинных докуменов: римские формаы номеров сраниц, нумерация срок, водяные знаки (совмесимо с командой Word «Удалить водяной знак»), многоколончные разделы, поле «Ср. X из Y».

• Защиа докумена с совмесмым с Word SHA-512 хешированием пароля (побайово проверено на выходе самго Word); режим trackedChanges зас авляе получаелей ос авляь изменения отлеживаемыми.

• Операции со срукурой: move_section (заголовок вмесе со всем разделом, включая аблцы), перенос шаблона (переоформление под эалонный докумен с переназнанием сілей по именам), пользоваельские сіли, сіли знаков, свойсва докумена, альернаивный екс изображений.

• Дополнения для аблц: сроки gridBefore/ridAfter, именованные сіли аблц, сор ировка, разбиение, поворение сроки заголовка, ч ение/запись вложенных аблц, направление екс а в ячейке.

• Редкие возможнос і фора ирования: капіель (small caps), скрыый екс, межсимвольный инервал, кернинг, указание языка для CJK, позиции абуляции с заполни елями, границы и заливка абзацев, конроль висячих срок, смена регисра.

• Анализ: подсчё слов по разделам, проверка соовес вия ци а с андар у APA, ошибки проверки правописания и с аис ика удобочи аемос и Word, объединение глав, объединение изменений рецензен ов, сохранение с шифрованием паролем.

Чо делае его особенным

• Операции с колонками аблц с учёом объединения. delee_columns / inser_columns корректно рабо аю с горизон ально и вер икально объединёнными ячейками (gridSpan сжимаеся, цепочки vMerge переус анавливаюся). На момен написания ни один другой публичный Word MCP э им не обладае.

• API массовых операций. Редакирование 20 ячеек — э о ОДИН вызо se_cells с полезной нагрузкой, а не 20 отдельных обращений.

• Запись о слеживаемых изменений. Переда rack=True, auhor="Jane" в инсрумены replace/inser/delee/cell создаё нас оящие ревизии Word, о орые получа ель може приня ь или о клони ь, — проверено в цикле на собс венном механизме ревизий сервера.

• Сравнение докумен ов. com_compare_documens создаё на ивное для Word сравнение (redline) между двумя версиями докумен а.

• Никог да не пор и докумен ы. А омарное сохранение (временный файл → проверка срукуры → замена), ав ома ическое резервное копирование с ме кой времени перед каждым изменением, побай ов о иден ичный проход всего, ч о не редакируеся (уравнения, екс овые блоки, елемен ы управ ления содержимым ос аюся не ронуыми), и поня ные с рого ипизированные ошибки — файл, окры ый в Word, о кло няе ся сообщением, а не зависанием.

• Ус ойчив к фрагмен ированным run. Поиск/замена рабо аю на произвольно разби ых run в Word, сохраняя посимвольное фор а ирование, с защи ой о ReDoS по аймау у для пользова ельских регулярных выражений и опциональным огранич нием радиуса поражения через max_replacemens.

Ребования

• Windows (инсрумен ы COM ребую усановленного Microsof Word; все ос альные инсрумен ы — э о чис ая рабо а с файлами и рабо аю без Word)

• Pyhon 3.12+ (разрабо ано на 3.14)

Ус ановка

git clone https://github.com/nometalalchemist/KitchenSink4Word
cd KitchenSink4Word
python -m venv .venv
.venv\Scripts\pip install -e .

Зареги срируй е в Claude Code:

claude mcp add word -s user -- <absolute-path-to>\word-mcp\.venv\Scripts\word-mcp.exe

Модель безопаснос и

• Каждый изменяющий инсрумен принимае file_path и перед первым изменением создаё рядом с ним файл <name>.bak-<imesamp>.docx (backup=False — пропус и ь).

• Сохранения а омарны и проверены; при неудачной операции оригинал ос аё ся побай ов о иден ичен.

• Удаление содержимого, которое несё ссылки на сноски, ав ома ически удаляе еперь осиро евшие определния; validae_documen / validae_noes сообщаю о целос нос и в обоих направлниях.

• Удаление абзацев не допускае диапазоны, о орые разрезали бы поле (TOC, PAGEREF) пополам или молча прогло или разрыв раздела.

Тес ирование

344 ес а, рабо ающие везде: набор ес ов разраба ывался на закры ом корпусе реальных докумен ов (главы длиной в книгу, докумен , содержащий 171 сноску, рукопись со 126 о слеживаемыми изменениями и комен ариями рецензен ов), а CI ав ома ически генерируе срукурно эквивален ные син е ические замени ели (es/make_corpus.py), к ак ч о весь набор ес ов выполняется на любой машине — включая вашу и каждый pull reques. Локальные реальные докумен ы, если они ес ь, имею приори е . es/word_validar.py окрывае результаты в невидимом Word и падае при любом предупреждении о восс ановлении — оконч а ельная пров ерка на поврежение.

Исория разрабо ки: создан с помощью Claude Code за один день (2026-08-27), про ес ирован в ри раунда — модульные кон рольные очки на каждом э апе, сеанс граничных случаев (89 выз ов), два раунда в «безумном режиме» через сырой ранспор MCP sdio (нагрузочные испы ания масш абируемос и, па ологические опологии объединений, фаззинг Unicode/схем, ReDoS, жизненный цикл блокировки Word, пров ерки у ечек COM), а акже отдельная охо а за багами межфункционального взаимодейс вия. Все находки исправлены регрессионными ес ами. В research/ описаны алгори мы OOXML и подводные камни, на о орых пос роена реализация, с указанием аворс ва изученных э алонных реализаций под лицензией MI.

Извесные ограничения

• Не живо о редакирования докумен ов, о кры ых в Word (чис ый о каз; инсрумен ы COM рабо аю с сохранёнными файлами).

• Номера с раниц в оглавлении/списках иллюсраций ребую обновления полей: ав ома ически при следующем о кры ии в Word (updae_on_open), или немедленно через com_refresh_fields.

Лицензия

PolyForm Noncommercial 1.0.0 — беспла на для личного, академического, исследова ельского и любого другого некоммерческого использования. Для коммерческого использования ребуе ся о дельная лицензия до начала использования — о крой е issue, ч обы договори ься.