# MCP DOCX Translator

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

## Особенности

- ✅ Полное сохранение форматирования (стили, таблицы, изображения, списки)
- ✅ Прямая работа с XML без конвертации в промежуточные форматы
- ✅ Структурная валидация исходного и переведенного документа
- ✅ Оптимизация запросов через батчинг и кэширование
- ✅ Обработка больших документов через streaming
- ✅ Детальное логирование и отчетность

## Установка

```bash
npm install
npm run build
```

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

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

```
GOOGLE_API_KEY=your_api_key_here
```

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

```bash
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](./CLAUDE.md)

## Разработка

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

## Лицензия

MIT