Arabic Ms Word

---

🌟 المحتويات | Table of Contents

• العربية (Arabic)
  • المميزات الرئيسية
  • حل معضلة انحراف العناوين (BiDi OpenXML Surgery)
  • المعاينة الصورية للصفحات ونظافة المجلد (Pages/)
  • فهرس الأدوات المتاحة (15 Tools)
  • طريقة التركيب والتشغيل عبر npx
  • إعدادات العميل (mcp_config.json)
• English Section
  • Key Features
  • Tools Inventory (15 Tools)
  • Installation & Setup

---

🇸🇦 العربية

🚀 المميزات الرئيسية

1. جراحة OpenXML وإصلاح انحراف العناوين والنصوص (BiDi OpenXML Surgery):
   • القضاء التام على انحراف العناوين نحو اليسار بفضل ضبط خصائص الفقرة <w:jc w:val="right"/> ومنع تضارب <w:bidi/>.
   • منع انفصال العناوين المعلقة عن متونها في نهايات الصفحات (w:keepNext).
   • حماية الآيات القرآنية والأحاديث الشريفة من الانشطار عبر فواصل الصفحات (w:keepLines).
   • ضبط محاذاة المتون العربية بهوامش متطابقة (w:bidi + w:jc="both").
2. نظام المعاينة الصورية للصفحات (Pages/ Directory):
   • تحويل المستند إلى PDF وتوليد صور عالية الدقة (150/300 DPI) لكل صفحة داخل مجلد فرعي نظيف ومستقل باسم Pages/.
   • فحص وكشف العيوب البصرية (العناوين المعلقة، الفراغات الزائدة، توازن الأسطر).
3. بروتوكول نظافة مساحة العمل (Clean Workspace Protocol):
   • عدم إنشاء أي ملفات بايثون أو سكربتات مبعثرة في مجلد المستخدم الأساسي، وحصر مخرجات العمل في المستند الأصلي وملف PDF ومجلد Pages/.
4. دعم كامل للتيبوغرافيا وإصلاح النصوص العربية:
   • تصحيح الأقواس المقلوبة، توحيد الأرقام (شرقية/غربية)، وتنسيق همزات الألف والياء.
5. أتمتة ذكية دون الحاجة لأوامر نصية (Zero Slash-Commands):
   • محرك تحليل المقاصد (resolve_and_execute_document_intent) يفهم طلباتك النصية العادية ويقوم بتوليد وتصحيح المستند تلقائياً.

---

🔬 حل معضلة انحراف العناوين (BiDi OpenXML Surgery)

في بنية OpenXML، يؤدي وضع <w:bidi/> داخل خصائص الفقرة مع <w:jc w:val="right"/> إلى تفسيره كجهة يمنى منطقية لقارئ LTR، مما يجعله يعرض فيزيائياً في أقصى يسار الصفحة!

المعادلة المعتمدة في السيرفر:

• العناوين: <w:jc w:val="right"/> + <w:keepNext/> + <w:widowControl/> مع وسم <w:rtl/> في مسارات النصوص.
• متون الفقرات: <w:bidi/> + <w:jc w:val="both"/> مع وسم <w:rtl/>.
• الآيات والأحاديث: <w:keepLines/> + <w:bidi/> + تمييز لوني.
• المقاطع الإنجليزية: <w:jc w:val="left"/> خالية تماماً من وسوم bidi و rtl.

---

🛠️ فهرس الأدوات المتاحة (15 Tools)

اسم الأداة	الوصف والتطبيق
enforce_arabic_bidi_and_typography	جراحة OpenXML وضبط محاذاة العناوين لليمين ومنع انشطار الآيات وحماية المتون وتوليد الترقيم.
audit_and_render_document_pages	تحويل المستند لصور عالية الدقة داخل مجلد Pages/ وفحص العيوب البصرية والهيكلية.
resolve_and_execute_document_intent	إنشاء وتنسيق مستند وورد عربي كامل خطوة واحدة من خلال الوصف النصي العادي.
repair_arabic_text_formatting	فحص وإصلاح عيوب التيبوغرافيا العربية للأقواس المقلوبة والأرقام والألف والياء والمسافات.
decompress_and_modify_word_xml	تفكيك أرشيف docx والتعديل الجراحي بالـ Regex على أي ملف XML داخلي (document, styles, numbering).
create_word_document	إنشاء مستند .docx جديد بتحديد المقاس والبهامش والخط والاتجاه الافتراضي.
add_paragraph_to_document	إدراج فقرة نصية منسقة (الخط، الحجم، اللون، الاتجاه، الكشيدة، المسافات).
add_heading_to_document	إدراج عناوين رئيسية أو فرعية (H1-H6) بلون وتنسيق مخصص.
add_table_to_document	إدراج جدول بيانات متوافق مع الاتجاه العربي مع ألوان الهيدر والصفوف.
add_image_to_document	تضمين صور (PNG/JPEG) داخل المستند بأبعاد ومحاذاة محددة.
add_header_footer_to_document	ضبط رأس وتذييل المستند وترقيم الصفحات العربي (صفحة X من Y).
inspect_word_document	فحص مستند وورد واستخراج عدد الفقرات والعناوين والجداول والخطوط المكتشفة.
convert_word_to_markdown	استخراج محتوى مستند الوورد وتحويله إلى صيغة Markdown منظمة.
inject_template_data	دمج بيانات JSON في قالب وورد يحتوي على متغيرات {placeholder}.
modify_word_xml_element	استبدال نصوص أو عناصر شفرة WordprocessingML XML مباشرة.

---

📦 طريقة التركيب والتشغيل عبر npx

npx -y mcp-arabic-ms-word@latest

---

⚙️ إعدادات العميل القياسية (mcp_config.json)

{
  "mcpServers": {
    "mcp-arabic-ms-word": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-arabic-ms-word@latest"
      ]
    }
  }
}

---

🇬🇧 English Version

Key Features

• BiDi OpenXML Surgery Engine: Deep OpenXML surgery preventing heading drift, orphan headings (keepNext), split verses (keepLines), and ensuring clean margin-to-margin body justification.
• Visual Page Audit & Pages/ Workflow: Automatically renders Word documents to high-resolution page images into an isolated Pages/ directory with automated layout defect diagnostics.
• Clean Workspace Protocol: Prevents file pollution by keeping all scratch files internal and delivering pristine .docx, .pdf, and Pages/ artifacts.
• Arabic Text Repair Engine: Automatic correction of inverted brackets in RTL text, digit standardization (Eastern/Western), whitespace trimming, and Alef/Yeh normalization.
• WordMasterAgent Architecture: Orchestrates 15 specialized MCP tools across 6 master skills.

---

📜 الترخيص والملكية | License & Author

• المؤلف والحقوق | Author: MarwanDevSpace
• الترخيص | License: MIT License