Srt Translator

خادم MCP ذكي لترجمة ومعالجة ملفات الترجمة السينمائية (SRT) مع الحفاظ على التوقيت والسياق

English | العربية

---

🇸🇦 نظرة عامة (العربية)

SRT Translator MCP Hub هو خادم محلي متقدم مبني وفق معيار Model Context Protocol (MCP)، صُمم لتمكين نماذج الذكاء الاصطناعي من قراءة، تحليل، وترجمة ملفات الترجمة السينمائية بصيغة SRT بدقة متناهية، مع الحفاظ الصارم على أرقام المشاهد والفواصل الزمنية (Timecodes).

🎯 القيمة التقنية

تتطلب ترجمة الأفلام والمسلسلات فهماً سياقياً للمشاهد بدلاً من الترجمة الحرفية الجافة، إضافة إلى الحفاظ على بنية ملفات التوقيت دون أي تلف. يوفر هذا الخادم أدوات برمجية متكاملة لتقسيم النصوص الطويلة، فحص الترميز (Encoding)، ومعالجة الترجمة بأسلوب سينمائي احترافي.

---

🚀 المميزات التقنية

• معالجة دقيقة لملفات SRT: قراءة وتعديل الأسطر مع الحفاظ التام على تسلسل التوقيت (hh:mm:ss,ms).
• الحفاظ على السياق الدرامي: دعم التمرير الذكي للنصوص لتمكين النموذج من فهم سياق الحوار بين الشخصيات.
• دعم ترميز UTF-8: تفادي مشاكل الحروف العربية المعكوسة أو التالفة وضمان التوافق مع مشغلات الفيديو.
• إدارة الحزم والكتل (Batch Processing): إمكانية تجزئة الملفات الكبيرة لترجمتها على دفعات متناسقة دون استهلاك زائد للسياق.

---

🛠️ الأدوات المتاحة (Tools)

الأداة	الوظيفة
read_srt_file	قراءة محتوى ملف الترجمة واستخراج النصوص مع التوقيت.
save_srt_file	حفظ ملف الترجمة المترجم بالتنسيق الصحيح مع ترميز UTF-8.
validate_srt_timing	فحص سلامة الفواصل الزمنية وخلو الملف من أخطاء التنسيق.

---

⚙️ التثبيت والتشغيل

1. تثبيت المتطلبات: pip install -r requirements.txt

2. تشغيل السيرفر: python translator_mcp_server.py سيعمل السيرفر على المنفذ 8001.

3. ضبط إعدادات العميل (MCP Client): منفذ الاتصال المحلي الافتراضي هو: http://127.0.0.1:8001

---

🇬🇧 Overview (English)

SRT Translator MCP Hub is an advanced local server adhering to the Model Context Protocol (MCP) designed to give LLMs structured control over parsing, translating, and rebuilding cinema subtitle files (SRT).

🎯 Key Architectural Strengths

• Timecode Integrity: Strictly preserves frame timecodes, indices, and format boundaries during translation.
• Context-Aware Dialogue Translation: Structured block parsing ensures conversations maintain natural dramatic flow rather than literal translation.
• Universal Encoding: Native UTF-8 handling to prevent character corruption across video players.
• Chunk & Batch Management: Safely splits long movies into optimized subtitle blocks for LLM context processing.

---

🛠️ Exposed MCP Tools

Tool	Purpose
read_srt_file	Parses and extracts blocks, lines, and timecodes from an SRT file.
save_srt_file	Writes translated dialogue back into valid SRT format with UTF-8 encoding.
validate_srt_timing	Verifies subtitle structure and validates sequential timestamp integrity.

---

⚙️ Installation & Usage

1. Install dependencies: pip install -r requirements.txt

2. Launch server: python translator_mcp_server.py Listens by default on: http://127.0.0.1:8001

3. Connect your MCP client to: http://127.0.0.1:8001

---

📄 License

Open source under the MIT License.