MCP DOCX Translator

MCP-сервер для перевода документов DOCX через Google Translate API с полным сохранением исходной разметки и структуры.

Особенности

• ✅ Полное сохранение форматирования (стили, таблицы, изображения, списки)

• ✅ Прямая работа с XML без конвертации в промежуточные форматы

• ✅ Структурная валидация исходного и переведенного документа

• ✅ Оптимизация запросов через батчинг и кэширование

• ✅ Обработка больших документов через streaming

• ✅ Детальное логирование и отчетность

Установка

npm install
npm run build

Конфигурация

Создайте файл .env:

GOOGLE_API_KEY=your_api_key_here

Использование

npm start

MCP Инструменты

• translate_docx - перевод DOCX документа

• validate_translation - валидация существующего перевода

• get_translation_status - статус текущей операции

Архитектура

Проект состоит из 7 независимых модулей:

1. DocxParser - извлечение и парсинг XML из DOCX

2. TranslationService - интеграция с Google Translate API

3. StructureValidator - валидация структуры документа

4. DocumentReconstructor - восстановление документа с переводами

5. QualityChecker - проверка качества перевода

6. FileManager - управление файлами и логирование

7. MCP Server Core - оркестрация и регистрация инструментов

Подробнее см. CLAUDE.md

Разработка

npm run dev      # watch mode
npm test         # тесты
npm run lint     # линтинг

Лицензия

MIT