خادم خبير وورد العربي — MCP Arabic Microsoft Word Server

خادم بروتوكول MCP المتقدم (WordMasterAgent) المتخصص في إنشاء وتنسيق وحقن وفحص وإصلاح نصوص وتفكيك شفرات XML لمستندات Microsoft Word بدعم كامل ودقيق للغة العربية والاتجاه من اليمين إلى اليسار (RTL)، مع نظام جراحة OpenXML وضبط BiDi، وفحص الصفحات الصوري (Pages/)، وبروتوكول نظافة مساحة العمل.

🌟 المحتويات | 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