Install
pip install markitdown-mcpلمن يناسب
يناسب من يريد تحويل مستند أو صفحة ويب إلى Markdown على هذا الجهاز وتسليمه لوكيل موثوق. الأدلة تنص: يوفّر markitdown-mcp خوادم خفيفة STDIO وStreamable HTTP وSSE، ويعرّض أداة واحدة convert_to_markdown(uri)؛ ويمكن أن يكون uri من نوع http: أو https: أو file: أو data:.
صُمم لـوكلاء محليين موثوقين. لا توجد مصادقة؛ صلاحيات العملية تساوي المستخدم الذي شغّلها. convert_to_markdown يقرأ أي ملف يستطيع ذلك المستخدم قراءته، ويمكنه جلب بيانات الشبكة. لا تفتحه لعملاء غير موثوقين على جهاز مشترك.
الأدلة لا تسرد العملاء. لا تربط HTTP/SSE بغير localhost ما لم تفهم المخاطر.
أول محاولة في 3 دقائق
اتبع مسار pip الرئيسي ولا تجعل Docker التثبيت الأساسي:
pip install markitdown-mcp
markitdown-mcp
الافتراضي STDIO. عند الحاجة إلى HTTP/SSE تعطي الأدلة:
markitdown-mcp --http --host 127.0.0.1 --port 3001
في المرة الأولى استخدم STDIO وأبقِ الربط على هذا الجهاز.
المتطلبات: Python/pip المحليون يعملان؛ التحويل الأول صفحة https: لديك حق الوصول العام إليها — لا تطعم أولًا ملف مفاتيح ولا file: داخليًا. سيقرأ عنوان URI الذي تحدده وقد يخرج إلى الشبكة.
موضع الإعداد: في MCP للعميل اجعل command هو markitdown-mcp (stdio). افتح HTTP فقط بعد أن تفهم أن أي عملية على هذا الجهاز يمكنها الوصول.
أول استدعاء منخفض المخاطر: convert_to_markdown(uri) مع uri عام من نوع https:. لا تستخدم file: يشير إلى المجلد الشخصي أو الأسرار، ولا تغيّر --host.
إشارة النجاح: تعيد الأداة Markdown المحوّل من ذلك URI. إن لم ترتفع العملية فتحقق أولًا من اسم حزمة pip ولا تنتقل إلى Docker.
حالات الاستخدام
الحالة 1: تحويل صفحة عامة إلى Markdown. استدعِ convert_to_markdown مع uri من نوع https:. الأدلة تضمن فقط قبول هذا النوع من URI؛ ولا تكتب أسلوب الإخراج ولا سقف الحجم ولا معالجة جدران تسجيل الدخول. ما يمكن تأكيده: ترى النص المحوّل.
الحالة 2: تحويل ملف محلي إلى Markdown. uri من نوع file:. يقرأ القرص بصلاحيات مستخدم الخادم؛ وفي وضع HTTP/SSE يمكن لعمليات أخرى على هذا الجهاز إثارة القراءة نفسها. أكّد أولًا أن المسار لا يحتوي أسرارًا. يدخل URI من نوع data: التحويل أيضًا؛ الأدلة لا تكتب حدًا للطول. بناء Docker هو docker build -t markitdown-mcp:latest . ثم docker run -it --rm markitdown-mcp:latest، وليس نفس المسار الرئيسي لـ pip.
حدود الاستخدام
بلا مصادقة؛ الصلاحيات تساوي مستخدم التشغيل. HTTP/SSE يرتبط افتراضيًا بـ localhost وما زال يمكن لعمليات أو مستخدمين آخرين على هذا الجهاز الوصول. لا تربطه ببطاقة شبكة أخرى. الأداة الوحيدة هي convert_to_markdown. يقرأ الملفات وبيانات الشبكة التي يستطيع المستخدم قراءتها — ليست بلا مخاطر وليست كتابة قابلة للإلغاء: الأدلة لا تحتوي undo. لا تعامل Docker وpip كتثبيتين رئيسيين متوازيين.