MCP DOCX Translator

MCP server for translating DOCX documents via Google Translate API with full preservation of the original markup and structure.

Features

• ✅ Full preservation of formatting (styles, tables, images, lists)

• ✅ Direct XML processing without conversion to intermediate formats

• ✅ Structural validation of the source and translated document

• ✅ Request optimization through batching and caching

• ✅ Large document handling via streaming

• ✅ Detailed logging and reporting

Installation

npm install
npm run build

Configuration

Create a .env file:

GOOGLE_API_KEY=your_api_key_here

Usage

npm start

MCP Tools

• translate_docx - translate a DOCX document

• validate_translation - validate an existing translation

• get_translation_status - status of the current operation

Architecture

The project consists of 7 independent modules:

1. DocxParser - extraction and parsing of XML from DOCX

2. TranslationService - integration with Google Translate API

3. StructureValidator - document structure validation

4. DocumentReconstructor - document reconstruction with translations

5. QualityChecker - translation quality checking

6. FileManager - file management and logging

7. MCP Server Core - orchestration and tool registration

See CLAUDE.md for details

Development

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

License

MIT