خادم Solr Search MCP

ماذا يفعل خادم “Solr Search” MCP؟

يعمل خادم Solr Search MCP كطبقة تكامل بين نماذج اللغة الكبيرة (LLMs) وApache Solr، وهو منصة بحث مفتوحة المصدر قوية. من خلال الاستفادة من بروتوكول Model Context Protocol (MCP)، يسمح هذا الخادم للمساعدين الذكيين بالبحث، والاسترجاع، والتفاعل مع الوثائق المخزنة في مجموعات Solr. يتيح إمكانيات البحث والاسترجاع في Solr كموارد وأدوات موحدة، مما يمكّن من وصول مبسط وآمن من حيث النوع ومصادق عليه من تطبيقات العملاء. يمكن للمطورين استخدام هذا الخادم لتمكين LLMs من ميزات البحث المتقدمة، بما في ذلك الاستعلامات المعقدة، وتصفية الوثائق، والفرز، والتقسيم (pagination)، والاسترجاع المباشر للوثائق—وكل ذلك ضمن سير عمل آمن وغير متزامن. هذا يعزز سير عمل التطوير بجعل البحث المؤسسي متاحاً للأنظمة المدعومة بالذكاء الاصطناعي.

قائمة المطالبات

لا توجد قوالب مطالبات صريحة مذكورة في الوثائق أو ملفات المستودع المتاحة.

قائمة الموارد

• مورد بحث وثائق Solr
  يتيح لمستخدمي MCP الوصول إلى مجموعات Solr والبحث عبر الوثائق المفهرسة.
• مورد استرجاع الوثائق
  يمكّن من استرجاع وثائق معينة عبر معرّفاتها الفريدة من مجموعات Solr.
• مورد نتائج مفلترة ومفروزة
  يوفر تصفية وفرز متقدمين على استعلامات البحث لتحسين وتنظيم النتائج.
• مورد نتائج بحث مقسمة (Pagination)
  يدعم تقسيم النتائج لمجموعات بحث كبيرة، بحيث يمكن للعملاء الوصول إلى النتائج على دفعات قابلة للإدارة.

قائمة الأدوات

• أداة البحث المتقدم
  تتيح للـ LLMs تنفيذ استعلامات Solr معقدة عبر واجهة MCP، مع دعم العديد من معلمات البحث.
• أداة جلب الوثائق
  تمكّن LLMs من جلب تفاصيل الوثيقة الكاملة باستخدام معرّف الوثيقة من Solr.
• أداة تنفيذ الاستعلام غير المتزامن
  تتواصل مع Solr بطريقة غير حاجزة لتحقيق بحث واسترجاع فعالين.
• أداة المصادقة (JWT)
  توفر وصولاً آمناً ومصادقاً عليه إلى نقاط نهاية Solr عبر خادم MCP.

حالات استخدام هذا الخادم MCP

• بحث الوثائق المؤسسية
  التكامل مع نسخ Solr المؤسسية لتوفير بحث واسترجاع معرفي مدعوم بـ LLMs لفرق الدعم أو البحث.
• استكشاف قواعد الشيفرة
  استخدم Solr لفهرسة والبحث في الشيفرة أو الوثائق التقنية، مما يتيح للمطورين الاستعلام وتحليل قواعد الشيفرة عبر أدوات الذكاء الاصطناعي.
• تكامل واجهات برمجة التطبيقات للمساعدين الذكيين
  تزويد المساعدين الرقميين أو روبوتات الدردشة ببحث مدعوم بـ Solr للإجابة عن استفسارات المستخدمين من مجموعات بيانات كبيرة ومنظمة.
• توليد التقارير الآلي
  استرجاع وتجميع البيانات من مجموعات Solr لتوليد تقارير الأعمال أو التحليلات من خلال سير عمل الذكاء الاصطناعي.
• توصيل المحتوى الآمن
  التحكم في الوصول إلى الوثائق الحساسة عبر مصادقة JWT، مما يضمن أن التفاعل مع بيانات Solr يكون فقط من خلال LLMs مصرح لها.

كيفية إعداده

Windsurf

1. المتطلبات المسبقة: تأكد من تثبيت Python 3.11+ وDocker وuv.
2. تحديد ملف الإعداد: افتح ملف إعداد Windsurf الخاص بك.
3. إضافة خادم Solr Search MCP: أدرج أو حدّث كائن mcpServers بإعداد Solr Search MCP.
4. احفظ وأعد التشغيل: احفظ الإعداد وأعد تشغيل Windsurf.
5. تحقق من الإعداد: تأكد أن الخادم يعمل وقابل للوصول.

{
  "mcpServers": {
    "solr-search": {
      "command": "python",
      "args": ["run_server.py"]
    }
  }
}

تأمين مفاتيح API

استخدم متغيرات البيئة للبيانات الحساسة (مثل أسرار JWT).
مثال:

{
  "mcpServers": {
    "solr-search": {
      "command": "python",
      "args": ["run_server.py"],
      "env": {
        "JWT_SECRET": "${JWT_SECRET}"
      },
      "inputs": {
        "solr_url": "http://localhost:8983/solr"
      }
    }
  }
}

Claude

1. المتطلبات المسبقة: ثبّت التبعيات المطلوبة وSolr.
2. تعديل الإعداد: افتح ملف إعداد خادم Claude MCP.
3. إضافة مدخل الخادم: أدرج أمر الخادم ومعاملاته.
4. إعادة تشغيل Claude: أعد تحميل أو إعادة تشغيل خدمة Claude الخلفية.
5. اختبار الاتصال: تحقق من نجاح مصافحة MCP.

{
  "mcpServers": {
    "solr-search": {
      "command": "python",
      "args": ["run_server.py"]
    }
  }
}

Cursor

1. تثبيت التبعيات: تأكد من إعداد Python 3.11+ وDocker.
2. الوصول لإعدادات Cursor: حدد قسم خوادم MCP.
3. إدراج إعداد الخادم: أضف تفاصيل Solr Search.
4. تطبيق التغييرات: احفظ وأعد تشغيل Cursor.
5. التحقق: تأكد من حالة التشغيل.

{
  "mcpServers": {
    "solr-search": {
      "command": "python",
      "args": ["run_server.py"]
    }
  }
}

Cline

1. تحضير البيئة: يجب تثبيت Python وDocker وuv.
2. فتح إعدادات Cline: ابحث عن كتلة إعداد خادم MCP.
3. تهيئة الخادم: أضف تفاصيل Solr Search MCP.
4. إعادة تشغيل Cline: طبق تغييرات الإعداد.
5. التحقق من التكامل: نفّذ استعلام اختبار.

{
  "mcpServers": {
    "solr-search": {
      "command": "python",
      "args": ["run_server.py"]
    }
  }
}

كيفية استخدام هذا MCP داخل التدفقات

استخدام MCP في FlowHunt

لدمج خوادم MCP في سير عمل FlowHunt الخاص بك، ابدأ بإضافة مكون MCP إلى تدفقك وربطه بوكيل الذكاء الاصطناعي:

انقر على مكون MCP لفتح لوحة الإعدادات. في قسم إعداد النظام MCP، أدخل تفاصيل خادم MCP باستخدام تنسيق JSON التالي:

{
  "solr-search": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

بمجرد الإعداد، يصبح الوكيل الذكي قادراً على استخدام هذا MCP كأداة مع إمكانية الوصول إلى جميع وظائفه وقدراته. تذكر تغيير “solr-search” إلى اسم خادم MCP الفعلي الخاص بك واستبدال الرابط برابط خادم MCP الخاص بك.

نظرة عامة

رأيي: يوفر هذا الخادم MCP تكاملاً قوياً مع Solr وينفذ كل الأساسيات للبحث الآمن والمرن والآمن من حيث النوع للوثائق. ومع ذلك، يفتقر إلى قوالب المطالبات الصريحة ولا يذكر Roots أو دعم أخذ العينات، مما قد يقيّد تدفقات عمل عملاء MCP المتقدمة. التوثيق جيد لإعداد الوظائف والخصائص، لكنه محدود فيما يخص ميزات MCP العميقة.

درجة MCP

التقييم:
استناداً للجداول أعلاه، أقيّم هذا الخادم MCP بـ 6/10. إنه عملي ومتكامل جيداً مع Solr، لكنه يفتقر لبعض ميزات منظومة MCP (مثل roots، أخذ العينات، قوالب المطالبات)، ولا يحتوي على رخصة مفتوحة المصدر واضحة.