MCP DOCX Translator

Google Translate API를 통해 DOCX 문서를 번역하는 MCP 서버로, 원본 마크업과 구조를 완전히 보존합니다.

기능

• ✅ 서식 완전 보존 (스타일, 표, 이미지, 목록)

• ✅ 중간 형식으로 변환하지 않고 XML 직접 처리

• ✅ 원본 및 번역 문서의 구조적 검증

• ✅ 배칭 및 캐싱을 통한 요청 최적화

• ✅ 스트리밍을 통한 대용량 문서 처리

• ✅ 상세 로깅 및 보고

설치

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 - DOCX에서 XML 추출 및 파싱

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