Markdownify هو خادم بروتوكول سياق النموذج (MCP) يحول أنواع الملفات المختلفة ومحتوى الويب إلى تنسيق Markdown. يوفر مجموعة من الأدوات لتحويل ملفات PDF والصور والملفات الصوتية وصفحات الويب والمزيد إلى نص Markdown سهل القراءة والمشاركة.

نظرة عامة على المشروع

Markdownify MCP Server هو خادم بروتوكول سياق النموذج (MCP) تم تطويره بواسطة Zach Caceres (GitHub: zcaceres)، ويهدف إلى تحويل أنواع الملفات المختلفة ومحتوى صفحات الويب إلى تنسيق Markdown.

• الاستخدام الرئيسي: توفير خدمة موحدة لتحويل Markdown لوكلاء الذكاء الاصطناعي أو أدوات سطح المكتب.
• البيئات المدعومة: يعتمد على TypeScript + Node.js، ويعمل بالتنسيق مع مكونات أدوات Python.

---

الوظائف / الميزات الأساسية

✅ تحويل أنواع ملفات متعددة إلى Markdown

النوع	الأدوات المدعومة
المستندات	تحويل PDF و DOCX و XLSX و PPTX إلى Markdown
الوسائط	الصور (مع البيانات الوصفية)، الصوت (مع نص النسخ)
محتوى الويب	صفحات الويب العادية، مقاطع فيديو YouTube، نتائج بحث Bing

قائمة الأدوات الكاملة كما يلي (مأخوذة من README):

• pdf-to-markdown
• docx-to-markdown
• xlsx-to-markdown
• pptx-to-markdown
• image-to-markdown
• audio-to-markdown
• webpage-to-markdown
• youtube-to-markdown
• bing-search-to-markdown
• get-markdown-file: يسمح باسترجاع ملفات .md أو .markdown الموجودة

🔧 تهيئة البيئة وطريقة الاستخدام

1. استنساخ المستودع (Clone the repository)
2. تثبيت التبعيات: pnpm install (سيتم أيضًا تثبيت تبعيات uv/python)
3. البناء: pnpm run build
4. تشغيل الخدمة: pnpm start

يمكنك تشغيل وضع TS watch وتعديل src/server.ts أو src/tools.ts لتخصيص السلوك عبر pnpm run dev. يمكن أيضًا دمجه في عميل سطح المكتب (مثل Cursor)، عن طريق تعريف خدمة MCP هذه في ملف JSON الخاص بالتكوين.

⚙️ التكوينات الاختيارية

• يدعم تقييد الدليل المسموح بقراءة ملفات Markdown منه عبر متغير البيئة MD_SHARE_DIR، مما يحسن التحكم في الوصول ([github.com][1]).

ملخص وتوصيات

• المزايا

  • يدعم أنواع ملفات غنية، وظائف شاملة
  • سهولة التكامل، يمكن نشره بشكل تركيبي
  • مجتمع نشط، وثائق مفصلة، سهل البدء

• العيوب / ملاحظات

  • يوجد حاليًا خطر أمني متوسط، يوصى باستخدامه فقط في بيئة معزولة آمنة، أو انتظار التصحيح الرسمي
  • لا يزال دعم Windows بحاجة إلى تعزيز (يأمل مؤلف المشروع في وجود شخص يساعد في اختبار Windows PR)

• سيناريوهات التطبيق

  • عندما يحتاج مساعدو الذكاء الاصطناعي أو البرامج النصية الآلية إلى إدخال وإخراج Markdown موحد
  • في سيناريوهات مثل جمع المحتوى وأرشفة المستندات وتنظيم المواد البحثية
  • مشاريع الويب أو سطح المكتب التي ترغب في دمج خدمة تحويل متعددة التنسيقات إلى Markdown بسرعة