مقدمة تفصيلية لخادم Apify Actors MCP
نظرة عامة على المشروع
خادم Apify Actors MCP هو تطبيق خادم يعتمد على بروتوكول سياق النموذج (Model Context Protocol, MCP)، وهو مصمم خصيصًا لتوفير واجهة موحدة للوصول إلى جميع Actors على منصة Apify. يمكّن هذا المشروع تطبيقات الذكاء الاصطناعي ووكلاء الذكاء الاصطناعي من التفاعل مع أدوات استخراج البيانات في Apify من خلال بروتوكول موحد.
عنوان المشروع: https://github.com/apify/actors-mcp-server
الاستخدام الرئيسي: دمج أكثر من 200 أداة لاستخراج البيانات من Apify Store كأدوات ذكاء اصطناعي في مختلف تطبيقات الذكاء الاصطناعي
المنصات المدعومة: Claude Desktop، Visual Studio Code، LibreChat، والعديد من عملاء MCP الآخرين
الميزات والوظائف الأساسية
🔧 وضع النشر المزدوج
- MCP Server Actor: يعمل كخادم HTTP على منصة Apify، ويوفر الوصول من خلال أحداث يتم إرسالها من الخادم (SSE)
- خادم Stdio المحلي: يعمل على الجهاز المحلي، ويتواصل مع العميل من خلال الإدخال/الإخراج القياسي (stdio)
🛠️ تكامل غني بالأدوات
يقوم المشروع افتراضيًا بتكوين الأدوات الأساسية التالية:
- مستخرج Instagram (
apify/instagram-scraper): استخراج منشورات Instagram، والملفات الشخصية، والمواقع، والصور، والتعليقات
- متصفح الويب RAG (
apify/rag-web-browser): البحث في الويب، والزحف إلى محتوى الصفحات وإرجاع بيانات منظمة
- مستخرج معلومات الاتصال من خرائط Google (
lukaskrivka/google-maps-with-contact-details): استخراج معلومات الاتصال الخاصة بالشركات على خرائط Google
🔍 اكتشاف ذكي للأدوات
- get-actor-details: استرداد وثائق Actor محدد، ونمط الإدخال، والتفاصيل
- discover-actors: البحث عن Actors ذات الصلة باستخدام الكلمات الرئيسية وإرجاع التفاصيل
- إدارة الأدوات الديناميكية: دعم إضافة وإزالة أدوات Actor في وقت التشغيل (يتطلب دعم العميل)
🎯 دعم متعدد للعملاء
يدعم عملاء MCP التاليين:
- Claude Desktop: من خلال بروتوكول نقل Stdio
- Visual Studio Code: يدعم نقل Stdio و SSE
- LibreChat: يدعم نقل Stdio و SSE
- عميل اختبار Apify: دعم كامل لـ SSE ورأس التفويض
- عملاء MCP قياسيين آخرين
البنية التقنية
دعم البروتوكول
- MCP (Model Context Protocol): بروتوكول مفتوح، يحقق تفاعلًا آمنًا وخاضعًا للرقابة بين تطبيقات الذكاء الاصطناعي والأدوات الخارجية
- طرق النقل:
- Server-Sent Events (SSE) - للخوادم البعيدة HTTP
- Standard Input/Output (Stdio) - لاتصالات العمليات المحلية
تحسين معالجة الإدخال
- اقتطاع الوصف: تقييد الوصف بـ 500 حرف لتحسين التوافق
- تحسين حقول التعداد: دمج القيود على الطول في حدود 200 حرف
- علامات الحقول المطلوبة: تحديد المعلمات المطلوبة بوضوح
- بناء الخصائص المتداخلة: معالجة التكوينات المعقدة مثل تكوين الوكيل
- استنتاج النوع: استنتاج نوع عناصر المصفوفة تلقائيًا
أمثلة على حالات الاستخدام
تحليل أبحاث البيانات
"ابحث في الويب ولخص أحدث الاتجاهات في وكلاء الذكاء الاصطناعي"
"ابحث وحلل الملف الشخصي لـ The Rock على Instagram"
جمع المعلومات التجارية
"ابحث عن أفضل 10 مطاعم إيطالية في سان فرانسيسكو"
"استخرج معلومات الاتصال الخاصة بالشركات على خرائط Google لمنطقة معينة"
دعم إنشاء المحتوى
"قدم دليلًا تفصيليًا حول استخدام بروتوكول سياق النموذج وعناوين URL المصدر"
"حلل أحدث اتجاهات منشورات صفحة Facebook"
التثبيت والتكوين
تكوين Claude Desktop
{
"mcpServers": {
"actors-mcp-server": {
"command": "npx",
"args": ["-y", "@apify/actors-mcp-server"],
"env": {
"APIFY_TOKEN": "your-apify-token"
}
}
}
}
تكوين Visual Studio Code
{
"mcp": {
"inputs": [
{
"type": "promptString",
"id": "apify_token",
"description": "Apify API Token",
"password": true
}
],
"servers": {
"actors-mcp-server": {
"command": "npx",
"args": ["-y", "@apify/actors-mcp-server"],
"env": {
"APIFY_TOKEN": "${input:apify_token}"
}
}
}
}
}
تكوين Actor مخصص
{
"command": "npx",
"args": [
"-y", "@apify/actors-mcp-server",
"--actors", "lukaskrivka/google-maps-with-contact-details,apify/instagram-scraper"
],
"env": {
"APIFY_TOKEN": "your-apify-token"
}
}
متطلبات النظام
البيئة الأساسية
- Node.js: الإصدار 18 أو أحدث
- نظام التشغيل: macOS أو Windows أو Linux
- Apify API Token: للوصول إلى خدمات منصة Apify
متطلبات العميل
- أحدث إصدار من Claude Desktop
- Visual Studio Code (يدعم ملحق MCP)
- أو أي عميل MCP متوافق آخر
قيود الأداء
تكوين الموارد
- حد الذاكرة: 4 جيجابايت من الذاكرة لكل Actor
- المستخدمون المجانيون: إجمالي حد 8 جيجابايت، يجب تخصيص 128 ميجابايت لخادم MCP
- المعالجة المتزامنة: دعم تشغيل العديد من Actors في وقت واحد
تحسين البنية
- معالجة المخطط: توافق مع معيار JSON Schema
- تحسين الوصف: اقتطاع وتنسيق تلقائي
- معالجة الأخطاء: آلية شاملة لمعالجة الاستثناءات
التطوير والتصحيح
أداة فحص MCP
export APIFY_TOKEN=your-apify-token
npx @modelcontextprotocol/inspector npx -y @apify/actors-mcp-server
عميل مثال
يوفر المشروع أمثلة كاملة للتعليمات البرمجية:
- عميل Stdio:
examples/clientStdio.ts
- عميل SSE:
examples/clientSse.ts
ملخص المشروع
يمثل خادم Apify Actors MCP تقدمًا مهمًا في تكامل أدوات تطبيقات الذكاء الاصطناعي، حيث يوفر قدرات قوية لاستخراج البيانات لمختلف تطبيقات الذكاء الاصطناعي من خلال بروتوكول MCP الموحد. تشمل القيم الرئيسية للمشروع ما يلي:
المزايا الأساسية
- واجهة موحدة: الوصول إلى أكثر من 200 أداة احترافية لاستخراج البيانات من خلال بروتوكول واحد
- نشر مرن: دعم وضعي نشر: سحابي ومحلي
- توافق واسع: التكامل مع أدوات ومنصات تطوير الذكاء الاصطناعي السائدة
- سهولة التوسع: دعم إضافة وتخصيص أدوات Actor ديناميكيًا
قيمة التطبيق
- تحسين قدرات الذكاء الاصطناعي: تزويد تطبيقات الذكاء الاصطناعي بقدرات الحصول على البيانات في الوقت الفعلي
- تبسيط التكامل: واجهة موحدة تقلل من تعقيد التطوير
- توسيع الإمكانيات: بنية مفتوحة تدعم التوسع اللانهائي
- جاهزية المؤسسة: منصة ناضجة ودعم شامل للوثائق
سيناريوهات قابلة للتطبيق
- تطوير وكلاء الذكاء الاصطناعي
- تحليل أبحاث البيانات
- إنشاء المحتوى وإدارته
- ذكاء الأعمال وأبحاث السوق
- جمع البيانات الآلي
يوفر هذا المشروع حلاً قويًا ومرنًا وسهل الاستخدام لاحتياجات الحصول على البيانات لتطبيقات الذكاء الاصطناعي، وهو جزء مهم من مجموعة أدوات الذكاء الاصطناعي الحديثة.