تحليل المستندات باستخدام وكلاء الذكاء الاصطناعي باستخدام خادم GroupDocs.Parser Cloud MCP المفتوح المصدر

لمحة عامة

خادم GroupDocs.Parser Cloud MCP هو غلاف خفيف الوزن حول واجهة GroupDocs.Parser Cloud API يطبق Model Context Protocol (MCP). من خلال تقديم قدرات تحليل المستندات (نص، صور، باركود) وأدوات التخزين السحابي (قائمة، تحميل، تنزيل، حذف) كأدوات متوافقة مع MCP، يتيح الخادم لوكلاء الذكاء الاصطناعي، والمساعدين، وأدوات التطوير التفاعل مع المستندات كما لو كانت مصدر بيانات مدفوع بالنماذج. يزيل هذا الحاجة إلى استدعاءات SDK مخصصة أو تكاملات مالكية، مما يجعل من السهل تضمين استخراج المستندات في تدفقات عمل LLM، أدوات الإكمال التلقائي، أو بيئات المساعد البرمجي.

الفوائد الرئيسية تشمل:

وصول عالمي – أي عميل متوافق مع MCP (VS Code، Cursor، KiloCode، الوكلاء المخصصون وغيرها) يمكنه استدعاء نفس النقطة النهاية لتحليل المستندات المخزنة في GroupDocs Cloud.
استخراج غني – استرجاع النص الصافي، الصور المدمجة، والباركود من أكثر من 50 صيغة ملف (PDF، Word، Excel، PowerPoint، رسائل البريد، أرشيفات، إلخ).
عمليات التخزين – سرد المجلدات، تحميل ملفات جديدة، تنزيل الملفات الموجودة، وإدارة التخزين السحابي مباشرة عبر استدعاءات MCP.
متعدد المنصات – يعمل على Windows وmacOS وLinux من خلال خدمة واحدة مبنية بلغة Python.

فيما يلي تنقل سريع إلى الأقسام التي ترشدك عبر البروتوكول، التثبيت، التكوين للأدوات الشائعة، الخيارات المتقدمة، والأسئلة المتكررة.

ما هو Model Context Protocol (MCP)؟
لماذا استخدام خادم GroupDocs.Parser Cloud MCP؟
البدء السريع
استخدام MCP مع KiloCode
استخدام MCP مع Cursor
استخدام MCP مع VS Code
الخيارات المتقدمة
الخاتمة
انظر أيضاً
الأسئلة الشائعة

ما هو Model Context Protocol (MCP)؟

Model Context Protocol (MCP) هو واجهة معيارية تسمح للنماذج اللغوية الكبيرة (LLMs) ووكلاء الذكاء الاصطناعي بالتفاعل مع الأدوات والخدمات الخارجية بطريقة منظمة، قابلة للتنبؤ، وقابلة للاكتشاف.

بدلاً من دمج منطق الأعمال مباشرةً في التعليمات، يعرض MCP القدرات الخارجية (APIs، خدمات، مصادر بيانات) كـ أدوات مُعَرَّفة يمكن للوكيل استدعاؤها عند الحاجة.

مفاهيم MCP الأساسية

تكامل قائم على الأدوات
كل قدرة تُعرَّف كأداة tool لها هدف واضح (مثلاً، استخراج النص من مستند أو قائمة الملفات في التخزين). يمكن للوكلاء اختيار واستدعاء هذه الأدوات ديناميكيًا بناءً على نية المستخدم.
مخططات إدخال وإخراج مُعَرَّفة
تحدد أدوات MCP مدخلاتها ومخرجاتها باستخدام مخططات JSON. يزيل هذا الغموض، يقلل من الأخطاء الوهمية، ويسمح للنماذج بالتفكير حول الأداة المناسبة وكيفية استخدام النتيجة.
فصل صريح بين التفكير والتنفيذ
يركز LLM على التفكير واتخاذ القرار، بينما يتولى خادم MCP تنفيذ العمليات الحتمية مثل تحليل المستندات أو معالجة الملفات أو جلب البيانات.
قابلية إعادة الاستخدام عبر البيئات
أي عميل متوافق مع MCP (بيئات IDE الذكية، تطبيقات الدردشة، الوكلاء المستقلون، أدوات محلية) يمكنه الاتصال بنفس خادم MCP دون كتابة كود وسيط مخصص.

من خلال تنفيذ MCP، يصبح الخدمة مستعدة للذكاء الاصطناعي: يمكن اكتشاف وظائفها، وفهمها، واستدعاؤها بأمان من قبل وكلاء الذكاء الاصطناعي كجزء من سير عمل أكبر.

لماذا استخدام خادم GroupDocs.Parser Cloud MCP؟

الفائدة	كيف تساعدك
نقطة دمج واحدة	أي عميل متوافق مع MCP (Cursor، ملحقات VS Code، وكلاء الذكاء الاصطناعي، أدوات مخصصة) يمكنه الوصول إلى تحليل المستندات من خلال واجهة ثابتة واحدة.
استخلاص شامل للمحتوى	استخراج النص الصافي، الصور، والباركود من أكثر من 50 صيغة مستند، بما فيها PDF، DOCX، XLSX، PPTX، رسائل البريد الإلكتروني، والأرشيفات.
عمليات تخزين سحابي مدمجة	التعامل مع الملفات مباشرة في تخزين GroupDocs Cloud: تحميل، تنزيل، سرد المجلدات، التحقق من الوجود، وحذف الملفات كجزء من نفس سير العمل.
لا حاجة لدمج SDK في الوكلاء	لا تحتاج الوكلاء أو التطبيقات العميلة إلى تضمين أو إدارة SDK الخاص بـ GroupDocs؛ يتولى خادم MCP كل التواصل مع API والمصادقة.
متعدد المنصات ومستضاف ذاتيًا	تشغيل الخادم محليًا أو على البنية التحتية الخاصة بك باستخدام خدمة Python واحدة على Windows أو macOS أو Linux.
مصمم لتدفقات عمل الذكاء الاصطناعي	يعرِّف MCP أدوات مخططّة ببيانات ثابتة يمكن للوكلاء استدعاؤها بأمان ضمن عمليات التفكير والأتمتة.

البدء السريع

توضح هذه القسم كيفية ضبط وتشغيل خادم GroupDocs.Parser Cloud MCP في بضع خطوات فقط.

1. استنساخ المستودع

git clone https://github.com/groupdocs-parser-cloud/groupdocs-parser-cloud-mcp.git
cd groupdocs-parser-cloud-mcp

2. تكوين متغيّرات البيئة

أنشئ ملف .env يحتوي على بيانات اعتماد GroupDocs Cloud الخاصة بك. يمكنك إما إنشاء الملف يدويًا أو نسخ القالب .env.example.

CLIENT_ID=your-client-id
CLIENT_SECRET=your-client-secret
MCP_PORT=8000

يمكنك الحصول على Client ID وClient Secret من لوحة تحكم GroupDocs Cloud: https://dashboard.groupdocs.cloud/#/applications

3. تشغيل خادم MCP

اختر الأمر المناسب لنظام التشغيل الخاص بك.

Linux / macOS

./run_mcp.sh

Windows (PowerShell)

.\run_mcp.ps1

Windows (Command Prompt)

run_mcp.bat

نقطة النهاية الخاصة بالخادم

بعد بدء التشغيل، يصبح خادم MCP متاحًا على:

http://localhost:8000/mcp

يمكنك الآن ربط هذه النقطة النهاية بأي مضيف متوافق مع MCP، مثل وكلاء الذكاء الاصطناعي، مساعدي IDE، أو أدوات LLM التي تدعم Model Context Protocol.

استخدام MCP مع KiloCode

يمكن لـ KiloCode استدعاء أي نقطة نهاية MCP مباشرةً من واجهة الدردشة.

خطوات التحضير

افتح الإعدادات → MCP Servers في KiloCode.
أضف إدخال خادم جديد باسم groupdocs-parser-mcp-local.
الصق JSON التكويني (URL والنوع).

JSON تكوين KiloCode

{
  "mcpServers": {
    "groupdocs-parser-mcp-local": {
      "type": "streamable-http",
      "url": "http://127.0.0.1:8000/mcp"
    }
  }
}

أمثلة على الأوامر في KiloCode

Extract all text from sample_invoice.pdf using the GroupDocs.Parser MCP server, then give me a brief summary of the invoice amount

عند إرسال هذا الطلب، سيقوم KiloCode بـ:

تحميل sample_invoice.pdf إلى GroupDocs Cloud.
استدعاء طريقة MCP parse/text.
إرجاع ملخصًا يولده النموذج للفاتورة.

Extract all images from document.pdf, save them in current folder, subfolder “document_images” and after processing remove the images from GroupDocs.Cloud storage

سيقوم KiloCode بـ:

تحميل document.pdf إلى GroupDocs Cloud.
استدعاء أداة MCP لاستخراج الصور.
استدعاء نقطة النهاية parse/images عبر MCP لاستخراج الصور.
تحميل الصور المستخرجة وحفظها في المجلد document_images.
حذف الصور من تخزين GroupDocs.Cloud بعد الانتهاء.

استخدام MCP مع Cursor

لوحة “Tools & MCP” في Cursor تسمح لك بتسجيل خوادم MCP مخصصة.

خطوات الإعداد

افتح Cursor Settings → Tools & MCP.
اضغط Add Custom MCP.
الصق مقطع JSON التالي في قسم ملف mcp.json.

تكوين Cursor mcp.json

{
  "mcpServers": {
    "groupdocs-parser-mcp-local": {
      "url": "http://127.0.0.1:8000/mcp"
    }
  }
}

مثال على طلب في Cursor

Extract text from Message.msg using the GroupDocs.Parser MCP, then give me a brief summary of the email message.

سيقوم Cursor تلقائيًا بـ:

تحميل الملف إلى مساحة التخزين الشخصية في GroupDocs.Cloud
استرجاع النص باستخدام GroupDocs.Parser Cloud.
دمج النتائج في إجابة الدردشة.

استخدام MCP مع VS Code

يدعم VS Code خوادم MCP. سنوضح لك كيفية إعداد واستخدام ميزات خادم GroupDocs هنا.

خطوات التكوين

أنشئ مجلد .vscode داخل مشروعك إذا لم يكن موجودًا.
أضف ملفًا اسمه mcp.json يحتوي على تعريف الخادم.

مثال VS Code mcp.json

{
  "servers": {
    "groupdocs-parser-mcp-local": {
      "type": "http",
      "url": "http://127.0.0.1:8000/mcp"
    }
  }
}

أعد تحميل VS Code (Ctrl+Shift+P → Developer: Reload Window).
الآن يمكنك فتح الدردشة (Ctrl+Alt+I) وسيستدعي الدردشة أدوات MCP عند الطلب.

مثال طلب في الدردشة:

Parse the Invoice.pdf using the GroupDocs.Parser MCP, give me a brief summary of invoice.

الخيارات المتقدمة

اختبار الخادم باستخدام MCP Inspector

MCP Inspector أداة واجهة خفيفة تسمح لك باستكشاف مخططات الخادم وتجربة الاستدعاءات تفاعلًا.

# تشغيل المفتش (مطلوب Node.js)
npx @modelcontextprotocol/inspector

في المتصفح:

اختر “streamable HTTP” كنوع الاتصال.
أدخل عنوان الخادم: http://127.0.0.1:8000/mcp.
اضغط Connect وتصفح الطرق المتاحة (مثل parser_extract_text، parser_extract_barcodes).

إعادة تهيئة البيئة الافتراضية

إذا عدلت requirements.txt أو واجهت أخطاء في الاعتماديات، أعد تهيئة البيئة:

# Linux / macOS
./init_mcp.sh

# Windows PowerShell
.\init_mcp.ps1

# Windows CMD
init_mcp.bat

ستقوم السكريبتات بـ:

حذف المجلد .venv الحالي.
إنشاء بيئة افتراضية نظيفة.
إعادة تثبيت جميع الحزم من requirements.txt.

بعد إعادة الضبط، شغِّل الخادم مرة أخرى:

# Linux / macOS
./run.sh

# Windows PowerShell
.\run.ps1

# Windows CMD
run.bat

الخاتمة

في هذه المقالة استعرضنا:

ما هو MCP ولماذا يعد مهمًا لأدوات الذكاء الاصطناعي.
خادم GroupDocs.Parser Cloud MCP – جسر خفيف يضيف استخراج النصوص، الصور، والباركود بالإضافة إلى إدارة التخزين السحابي لأي عميل متوافق مع MCP.
خطوات التثبيت خطوة بخطوة (استنساخ، تكوين، تشغيل).
كيفية ربط الخادم ببيئات شائعة – KiloCode، Cursor، وVS Code.
تشخيصات متقدمة باستخدام MCP Inspector وإعادة تهيئة البيئة الافتراضية.

مع وجود خادم MCP، يمكن للمطورين السماح للنماذج اللغوية بالتفاعل مع المستندات كما تفعل مع قواعد البيانات أو واجهات برمجة التطبيقات، متجنبين كود SDK الزائد وتسريع تدفقات عمل الوثائق المدفوعة بالذكاء الاصطناعي.

انظر أيضاً

GroupDocs.Parser Cloud API Reference – https://reference.groupdocs.cloud/parser/
GroupDocs.Parser Cloud Documentation – https://docs.groupdocs.cloud/parser/
ابدأ تجربة مجانية – https://purchase.groupdocs.cloud/cloud/trial/
سياسات الشراء والأسئلة المتكررة – https://purchase.groupdocs.cloud/cloud/policies/

الأسئلة المتكررة (FAQs)

س: لماذا خادم MCP مفتوح المصدر ويُشغَّل محليًا؟ لماذا لا يوجد خادم MCP مستضاف للجمهور؟
ج: لا يزال Model Context Protocol (MCP) معيارًا جديدًا، وتواجه النماذج اللغوية الحالية دعمًا محدودًا أو غير موثوق لتدفقات الملفات الثنائية (PDF، صور، أرشيفات). تحليل المستندات، OCR، استخراج الصور، والتعرف على الباركود هي مجالات تتفرد فيها واجهات GroupDocs.Parser Cloud. يوفر الخادم المحلي جسرًا موثوقًا ومعياريًا لهذه الفجوة.
س: هل أحتاج إلى تثبيت أي برامج إضافية لاستخدام خادم MCP؟
ج: لا. يعمل الخادم على أي نظام تشغيل يدعم Python 3.10+ ويتطلب فقط الحزم المذكورة في requirements.txt.
س: ما هي صيغ المستندات المدعومة؟
ج: أكثر من 50 صيغة، بما فيها PDF، DOCX، XLSX، PPTX، رسائل البريد (.eml، .msg)، الأرشيفات (ZIP، RAR)، وأنواع الصور الشائعة (PNG، JPG، TIFF).
س: هل يمكنني استخراج الباركود من ملفات PDF ممسوحة ضوئيًا؟
ج: نعم. يدعم خادم MCP نقطة النهاية parse/barcodes التي تكتشف الباركود أحادي وثنائي الأبعاد في الصور النقطية وPDF.
س: كيف أقوم بسرد الملفات في مجلد معين على GroupDocs Cloud؟
ج: يدعم خادم MCP نقاط نهاية تخزين GroupDocs.Cloud (storage/list، storage/upload، storage/download، storage/delete) وتُستَخدم عمليات التخزين تلقائيًا في جلسات الدردشة أو بناءً على طلبك.
س: ماذا أفعل إذا غيرت منفذ MCP بعد تشغيل الخادم؟
ج: قم بتحديث قيمة MCP_PORT في ملف .env وأعد تشغيل الخادم (run.sh / run.ps1).
س: هل يحصل المستخدم على تجربة مجانية؟
ج: نعم، يتوفر 150 استدعاء API مجانيًا شهريًا.

لمحة عامة#

ما هو Model Context Protocol (MCP)؟#

مفاهيم MCP الأساسية#

لماذا استخدام خادم GroupDocs.Parser Cloud MCP؟#

البدء السريع#

1. استنساخ المستودع#

2. تكوين متغيّرات البيئة#

3. تشغيل خادم MCP#

Linux / macOS#

Windows (PowerShell)#

Windows (Command Prompt)#

نقطة النهاية الخاصة بالخادم#

استخدام MCP مع KiloCode#

استخدام MCP مع Cursor#

استخدام MCP مع VS Code#

الخيارات المتقدمة#

اختبار الخادم باستخدام MCP Inspector#

إعادة تهيئة البيئة الافتراضية#

الخاتمة#

انظر أيضاً#

الأسئلة المتكررة (FAQs)#