Install
"command": "uvx",
"args": ["--from", "git+https://github.com/nkapila6/mcpsurfr", "mcpsurfr"]لمن هذا مناسب
MCPSurfr (اسمه السابق mcp-local-rag) هو خادم MCP للبحث المحلي في الويب موجّه إلى نماذج LLM: لا يحتاج إلى مفاتيح API، وتُعاد ترتيب نتائج البحث على جهازك أنت، حيث يتولى الترتيب نموذج MobileBERT صغير يعمل مباشرة فوق numpy. يناسب فئتين: من يريد إضافة قدرة بحث ويب إلى عميل يدعم MCP دون التسجيل في خدمة بحث أو إدارة مفاتيح، وسير عمل الوكلاء التي تحتاج قدرات تتعمق تدريجيًا، من الاستعلام السريع لمرة واحدة عن المقاطع، إلى نص الصفحات الكاملة، ثم إلى بحث معمق متعدد المحركات.
يجب توضيح الشروط المسبقة: تحتاج إلى عميل يدعم خوادم MCP المخصصة وإلى جهاز قادر على تشغيل أمر uvx — فطريقة التشغيل الرسمية واحدة فقط: سحب الخادم من GitHub عبر uvx. لا تذكر الصفحة الرسمية ما إذا كانت تقدم خدمة مستضافة أو واجهة رسومية، ولا تسرد متطلبات نظام التشغيل ولا قائمة العملاء المتوافقين؛ وإذا كانت بيئتك لا تسمح بسحب الكود من GitHub وتنفيذه، فهذا المسار الرئيسي لن يعمل.
أول تجربة خلال 3 دقائق
المسار الرئيسي الموصى به واحد فقط، والأمر والإعداد كلاهما من الشرح الرسمي.
الشرط: أن يعمل uvx على الجهاز وأن يدعم العميل ضبط خوادم MCP عبر command/args. الخطوة الأولى: اكتب المقطع الرسمي في إعدادات خوادم MCP لدى العميل (ويختلف مكان اللصق باختلاف العميل):
"command": "uvx",
"args": ["--from", "git+https://github.com/nkapila6/mcpsurfr", "mcpsurfr"]
الخطوة الثانية: احفظ الإعداد وأعد تحميل الجلسة، وسيقوم العميل بتشغيل mcpsurfr بهذا الأمر. يتطلب التشغيل الأول الاتصال بالشبكة لسحب الكود من GitHub، ومدة ذلك وسلوك التخزين المؤقت غير مذكورين رسميًا.
الخطوة الثالثة: استدعِ أداة search بكلمة استعلام عادية. هي استعلام لمرة واحدة وفق التعريف الرسمي يعيد مقاطع ذات صلة، وتندرج ضمن عمليات الاستعلام؛ لكن الاستدعاء يطلق بحث ويب حقيقيًا وينفذ حساب إعادة الترتيب على جهازك — كونها استعلامًا يعني فقط أنها لا تنفذ عمليات كتابة، ولا يعني غياب طلبات الشبكة أو حدود الخصوصية.
إشارات النجاح: أن تعيد الأداة مقاطع نصية ذات صلة بكلمة الاستعلام، وأن تظهر في قائمة أدوات العميل، إلى جانب search، الأدوات rag_search_ddgs وrag_search_google وdeep_research وdeep_research_ddgs وdeep_research_google. يوفر الخادم أيضًا مورد المهارة skill://mcpsurfr-search/SKILL.md، واستخدامه المحدد غير مشروح في الصفحة الرسمية.
حالات الاستخدام
الحالة الأولى: إضافة بحث سريع للأسئلة العاجلة إلى المحادثة. الموقف: تناقش في العميل موضوعًا قد تكون طرأت عليه تطورات جديدة، وتطلب من النموذج أن يستدعي search أولًا. يجري استعلامًا لمرة واحدة ويعيد مقاطع ذات صلة يمكن للنموذج الاستشهاد بها مباشرة؛ ولأنه بلا مفاتيح API، فلن تحتاج عند الانتقال إلى بيئة جديدة إلى التسجيل في أي خدمة بحث. ما يمكن تأكيده ينتهي عند إرجاع المقاطع ذات الصلة، أما تفاصيل تقسيم المقاطع وترتيبها فغير مشروحة رسميًا.
الحالة الثانية: سحب نص صفحات كاملة لتنظيم موضوع. الموقف: عندما لا تكفي المقاطع وتحتاج سياقًا أكمل، استدعِ rag_search_ddgs؛ فبحسب الشرح الرسمي يعيد نص صفحات كاملة، وهو النمط الأصلي للمشروع. انتبه: الاستدعاء الواحد يعيد 40,000 حرف كحد أقصى، ويمكن ضبط ذلك عبر متغير البيئة MCPSURFR_MAX_CHARS. معاملات كل أداة بالتفصيل لم تذكرها الوثائق الرسمية بندًا بندًا؛ فاعتمد وصف الأدوات الذي يستنبظه عميلك بنفسه. وكيفية تنظيم سلسلة deep_research لبحث متعدد الخطوات غير مشروحة في الصفحة الرسمية — فلا تفترض سير عمل من عندك.
حدود الاستخدام
طبيعة القراءة والكتابة: الأدوات الست جميعها قدرات استعلام أو بحث، ولم تصف الصفحة الرسمية أي عمليات تكتب في ملفات محلية أو ترسل إلى جهة بعيدة؛ وهذا وصف للحدود وليس حكمًا أمنيًا — فالاستدعاء يطلق بحث ويب حقيقيًا ويعيد الترتيب على جهازك بواسطة MobileBERT (numpy).
بيانات الاعتماد والاعتماديات المحلية: الرسالة الرسمية هي عدم الحاجة إلى مفاتيح API؛ أما الحاجة إلى حساب أو رموز أو ملفات بيانات محلية فلم تُذكر في الصفحة الرسمية، فتعامل معها كغير مؤكدة.
الآثار الجانبية ونقاط التأكيد: التثبيت بحد ذاته يسحب الكود من GitHub عبر uvx وينفذه، وهذا سلوك متأصل في الإعداد الرسمي — اقبل ذلك قبل كتابة الإعداد؛ وبخلاف ذلك لم تصف الوثائق الرسمية أي آثار جانبية أخرى أو إجراءات تستلزم تأكيدًا.
القيود الرسمية والبنود غير المؤكدة: أدوات الصفحات الكاملة تعيد 40,000 حرف كحد أقصى للاستدعاء الواحد، ويمكن ضبطها عبر متغير البيئة MCPSURFR_MAX_CHARS. وما زال غير مؤكد: قائمة العملاء المتوافقين، وتوافر كل خلفية بحث وحصصها، وكلفة الأداء، وإمكانية النشر عن بُعد. تحقق من هذه الشروط في بيئتك قبل أن تجعلها أساس اختيارك.