واجهة برمجة تطبيقات البحث عبر الويب Ollama وخادم MCP

Ashley Innocent

Ashley Innocent

26 سبتمبر 2025

واجهة برمجة تطبيقات البحث عبر الويب Ollama وخادم MCP

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

💡
لاختبار هذه الميزات بكفاءة، قم بتنزيل Apidog مجانًا وادِر مكالمات API بسلاسة في مشاريع Ollama الخاصة بك.
زر

Ollama تعتبر منصة قوية لتشغيل نماذج اللغة الكبيرة محليًا. يستفيد المهندسون منها لنشر النماذج دون الاعتماد على الخدمات السحابية. ومع ذلك، فإن إضافة واجهة برمجة تطبيقات البحث على الويب توسع نطاقها. تسمح واجهة برمجة التطبيقات هذه للنماذج بالاستعلام عن الإنترنت مباشرة. وبالتالي، تتعامل التطبيقات مع الأحداث الجارية والبيانات الديناميكية بشكل أكثر فعالية.

يكمل خادم MCP هذا بتوفير بروتوكول موحد لتبادل السياق. يربط المطورون النماذج بالأدوات الخارجية بسهولة. على سبيل المثال، يتكامل خادم MCP مع عملاء مثل Cline وCodex وGoose. يتيح هذا الإعداد سير عمل معقدًا حيث تتفاعل النماذج مع نتائج البحث على الويب في الوقت الفعلي.

بالانتقال إلى التفاصيل الفنية، تعمل واجهة برمجة تطبيقات البحث على الويب من Ollama عبر نقاط نهاية REST. يرسل المستخدمون طلبات POST إلى https://ollama.com/api/web_search بمعامل استعلام. يعيد النظام النتائج ذات الصلة، بحد أقصى 10 افتراضيًا. بالإضافة إلى ذلك، تسترد واجهة برمجة تطبيقات جلب الويب على https://ollama.com/api/web_fetch المحتوى من عناوين URL محددة. يتطلب كلاهما مفتاح API من حساب Ollama.

تضمن Ollama إمكانية الوصول عبر جميع الأنظمة الأساسية. على نظام macOS، يقوم المستخدمون بالتثبيت عبر Homebrew. يقوم مستخدمو Windows بتنزيل الملف التنفيذي مباشرة. يدعم Linux مديري الحزم المباشرين. بغض النظر عن النظام الأساسي، تتكامل واجهة برمجة التطبيقات بشكل موحد.

ما يحتاج المطورون لمعرفته حول Ollama

تدعم Ollama الاستدلال المحلي للنماذج مثل Llama و Qwen. تقوم بتنزيل النماذج الكمية بكفاءة. يسحب المستخدمون النماذج بأوامر مثل ollama pull qwen3:4b. تعمل هذه العملية على التحسين للأجهزة مثل وحدات معالجة الرسوميات NVIDIA أو Apple Silicon.

علاوة على ذلك، تدعم Ollama المهام متعددة الوسائط. على سبيل المثال، تعالج الصور ومقاطع الفيديو جنبًا إلى جنب مع النصوص. تتطور المنصة بسرعة، مع تحديثات تعزز الجدولة ومعالجة السياق.

يقدر المطورون طبيعة Ollama مفتوحة المصدر. يمكنهم تخصيص النماذج دون قيود على البائع. ومع ذلك، تنشأ قيود مع المعرفة الثابتة. تكافح النماذج المدربة على البيانات القديمة مع المعلومات الحديثة. هنا، تتدخل واجهة برمجة تطبيقات البحث على الويب.

تعالج واجهة برمجة تطبيقات Ollama هذه الفجوة. إنها تعزز الاستجابات ببيانات جديدة. ونتيجة لذلك، تنخفض الهلوسات بشكل كبير. يبني المهندسون تطبيقات موثوقة للبحث أو الأتمتة.

بالانتقال إلى خادم MCP، يقوم هذا المكون بتوحيد التفاعلات. يسهل بروتوكول سياق النموذج (MCP) تبادل البيانات بين النماذج والأنظمة. تنفذ Ollama خادم MCP في Python، مما يتيح استخدام الأدوات بسلاسة.

على سبيل المثال، يتيح خادم MCP عمليات الملفات والحسابات والوصول إلى الويب. يقوم المطورون بتهيئته لـ LLMs المحلية، مما يوسع القدرات إلى ما هو أبعد من الاستدلال الأساسي.

استكشاف واجهة برمجة تطبيقات البحث على الويب من Ollama بعمق

تقدم واجهة برمجة تطبيقات البحث على الويب من Ollama نتائج منظمة. يحدد المستخدمون الاستعلامات وعدد النتائج الأقصى الاختياري. تتضمن الاستجابة مقتطفات وعناوين URL وبيانات وصفية. يساعد هذا التنسيق في التحليل للعوامل.

للدمج، يستخدم المطورون مكتبات Python. قم بالتثبيت باستخدام pip install ollama. ثم، استدعِ ollama.web_search(query="example"). تتعامل الدالة مع المصادقة عبر متغيرات البيئة.

وبالمثل، يستفيد مستخدمو JavaScript من ollama-js. استورد الوحدة واستدعِ Ollama().webSearch({query: "example"}). توضح الأمثلة في المستودعات معالجة الأخطاء وإعادة المحاولات.

يوفر cURL خيارًا منخفض المستوى. قم بإنشاء طلبات برؤوس للمصادقة (Authorization). يناسب هذا النهج البرمجة النصية أو الاختبار.

ومع ذلك، يعزز Apidog هذه العملية. كأداة لإدارة واجهات برمجة التطبيقات، يقوم Apidog بتصور نقاط النهاية والمعلمات. يقوم بإنشاء مقتطفات تعليمات برمجية لواجهة برمجة تطبيقات Ollama، مما يسرع عملية التطوير.

تدعم واجهة برمجة التطبيقات السياقات الطويلة. يمكن أن تمتد النتائج لآلاف الرموز المميزة. لذلك، تحقق النماذج ذات النوافذ الموسعة أفضل أداء. توصي Ollama بحد أدنى 32,000 رمز مميز.

علاوة على ذلك، تكمل نقطة نهاية الجلب البحث. إنها تستخرج المحتوى من عناوين URL، متجاوزة الحاجة المباشرة للمتصفح. اجمع بين الاثنين للحصول على وكلاء شاملين.

يبقى الأمان أمرًا بالغ الأهمية. تتطلب Ollama مفاتيح API، مما يمنع الوصول غير المصرح به. يقوم المستخدمون بإنشاء المفاتيح على https://ollama.com/settings/keys.



بالانتقال إلى الاستخدام العملي، فكر في وكيل بحث. يقوم الوكيل بالاستعلام عن البحث على الويب، وجلب الصفحات، وتجميع الإجابات. يتفوق سير العمل هذا على النماذج الثابتة.

تبسيط خادم MCP لمستخدمي Ollama

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

يتضمن الإعداد استنساخ المستودعات وتهيئة البيئات. على سبيل المثال، يقوم uv run web-search-mcp.py بتشغيله. يتصل العملاء عبر واجهات متوافقة.

يتم تكوين Cline باستخدام الأوامر في الإعدادات. أضف OLLAMA_API_KEY إلى البيئات. يقوم Codex بتعديل ملفات config.toml. تتبع Goose أنماطًا مماثلة.

يفتح هذا التكامل البحث على الويب في العملاء. تستدعي النماذج الأدوات ديناميكيًا، مما يعزز التفاعل.

علاوة على ذلك، يدعم خادم MCP الإضافات. يضيف المطورون أدوات مخصصة للبريد الإلكتروني أو GitHub أو الصور. تضع هذه المرونة Ollama كبنية تحتية للوكلاء.

على نظام Windows المزود بـ NVIDIA، تتضمن عمليات التثبيت برامج تشغيل CUDA. يستخدم Linux Docker للعزل. يستفيد macOS من التسريع الأصلي.

بالانتقال إلى الإعدادات المتقدمة، قم بتجميع عدة خوادم MCP. يوزع هذا الأحمال لمقاييس المؤسسات.

كيفية دمج واجهة برمجة تطبيقات Ollama وخادم MCP

يبدأ الدمج بإنشاء حساب. سجل مجانًا في موقع Ollama. أنشئ مفتاح API على الفور.

بعد ذلك، قم بتثبيت Ollama محليًا. قم بتشغيل ollama serve لبدء الخادم. اسحب النماذج المناسبة للأدوات، مثل gpt-oss.

للبحث على الويب، قم بتعيين OLLAMA_API_KEY. اختبر باستخدام Python:

import ollama

response = ollama.web_search(query="latest AI news", max_results=5)
print(response)

يعيد هذا JSON مع النتائج.

لدمج خادم MCP، قم بتنزيل الأمثلة من GitHub. قم بتشغيل السكربت وتهيئة العملاء.

بالنسبة لـ Cline: قم بتحرير التكوين للإشارة إلى نقطة نهاية MCP. اختبر المطالبات التي تستدعي البحث.

يتطلب Codex تحديثات toml. حدد الأمر والوسائط.

تتكامل Goose عبر إعدادات MCP، مما يتيح أدوات الويب.

علاوة على ذلك، قم ببناء وكلاء مخصصين. استخدم الحلقات للتعامل مع التفاعلات متعددة الأدوار. حلل استدعاءات الأدوات وأعد النتائج.

تثبت معالجة الأخطاء أنها حاسمة. نفذ عمليات إعادة المحاولة لقيود المعدل. راقب الاستخدام للبقاء ضمن المستويات.

يساعد Apidog هنا. إنه يحاكي الاستجابات، ويختبر المصادقة، ويوثق سير العمل. قم بتنزيل Apidog لإنشاء نماذج أولية لدمج Ollama بسرعة.

بناء وكلاء بحث أقوياء باستخدام Ollama

يمثل الوكلاء حالة استخدام أساسية. توفر Ollama أمثلة مع Qwen 3.

اسحب النموذج: ollama pull qwen3:4b.

في Python، حدد الأدوات:

tools = [
    {"type": "function", "function": {"name": "web_search", "description": "Search the web"}},
    {"type": "function", "function": {"name": "web_fetch", "description": "Fetch URL content"}}
]

تعالج حلقة الدردشة الرسائل، وتستدعي الأدوات، وتلحق النتائج.

يجيب هذا الوكيل على استعلامات مثل "ما هو الطقس الحالي في طوكيو؟" عن طريق البحث والجلب.

توسع إلى الرؤية: حلل الصور عبر نماذج متعددة الوسائط، ثم ابحث عن السياق.

بالانتقال إلى التحسين، قم بزيادة أطوال السياق. تتعامل النماذج السحابية مع السعة الكاملة.

يقلل الوكلاء التكاليف عن طريق تقليل المكالمات غير الضرورية. تخزين النتائج مؤقتًا محليًا.

علاوة على ذلك، ادمج مع واجهات برمجة تطبيقات أخرى. ادمج قواعد البيانات أو أدوات الحساب عبر MCP.

تفاصيل تسعير Ollama عبر الأنظمة الأساسية

تقدم Ollama تسعيرًا متعدد المستويات. الأساسي مجاني، مع حدود بحث سخية. يناسب هذا الهواة والاختبار.

للإنتاج، قم بترقية الاشتراكات. يبدأ الوصول السحابي بحوالي 20 دولارًا شهريًا، بناءً على مناقشات المجتمع. توفر المستويات الأعلى استعلامات غير محدودة ودعمًا ذا أولوية.

تؤثر الأنظمة الأساسية على التكاليف بشكل غير مباشر. التشغيل المحلي على macOS و Windows و Linux لا يترتب عليه رسوم تتجاوز الأجهزة. يتم فوترة النماذج السحابية حسب الاستخدام.

تفرض واجهة برمجة تطبيقات البحث على الويب رسومًا لكل مكالمة في الخطط المتقدمة. ومع ذلك، تغطي المستويات المجانية معظم الاحتياجات.

قارن بالبدائل: يكلف البحث في OpenAI 10 دولارات لكل 1000 مكالمة. تتفوق Ollama على هذا لمستخدمي التشغيل المحلي أولاً.

تحسب الشركات عائد الاستثمار. يوفر الاستدلال المحلي في نقل البيانات، بينما تضيف واجهة برمجة التطبيقات الحد الأدنى من النفقات العامة.

بالانتقال إلى الميزانية، راقب عبر لوحات المعلومات. توفر Ollama إحصائيات الاستخدام.

حالات الاستخدام والأمثلة الواقعية

يطبق المطورون هذا في روبوتات الدردشة. يقوم الروبوت بالبحث عن الأخبار، وجلب المقالات، وتلخيصها.

في التعليم، تستعلم الأدوات عن الحقائق، مما يقلل الأخطاء.

يبني الباحثون وكلاء لمراجعات الأدبيات. ابحث في المواقع الأكاديمية، واجلب ملفات PDF.

يتكامل التجارة الإلكترونية لتوصيات المنتجات. ابحث عن الاتجاهات، واجلب المراجعات.

مثال على كود الوكيل:

import ollama
import json

def run_agent(prompt):
    messages = [{"role": "user", "content": prompt}]
    while True:
        response = ollama.chat(model="qwen3:4b", messages=messages, tools=tools)
        if "tool_calls" in response["message"]:
            for call in response["message"]["tool_calls"]:
                if call["function"]["name"] == "web_search":
                    args = json.loads(call["function"]["arguments"])
                    result = ollama.web_search(**args)
                    messages.append({"role": "tool", "content": str(result)})
        else:
            return response["message"]["content"]

تتعامل هذه الحلقة مع التكرارات.

علاوة على ذلك، استخدام الرؤية: صف الصور، وابحث عن التطابقات.

تقوم الشركات بأتمتة التقارير. يقوم الوكلاء بتجميع البيانات من مصادر الويب.

فوائد اعتماد ميزات Ollama الجديدة

تعزز Ollama الخصوصية. تبقى البيانات محلية، مع مكالمات API اختيارية.

تتحسن الدقة عبر التعزيز في الوقت الفعلي. تتعامل النماذج مع المواضيع المتطورة.

تتبع قابلية التوسع. يوزع خادم MCP المهام.

تبرز كفاءة التكلفة. تقلل المستويات المجانية النفقات.

تزداد إنتاجية المطورين. تسرع عمليات الدمج مثل Apidog سير العمل.

بالانتقال إلى المجتمع، تناقش المنتديات التحسينات.

ينمو النظام البيئي. تتفاعل أدوات مثل OpenWebUI مع Ollama.

التحديات والحلول المحتملة

تشمل التحديات حدود المعدل. الحل: ترقية الاشتراكات.

تحد قيود الأجهزة النماذج. استخدم المتغيرات السحابية.

تنشأ تعقيدات التكامل. اتبع الوثائق والأمثلة.

الأمان: قم بتدوير مفاتيح API بانتظام.

يتطلب تصحيح أخطاء الوكلاء تسجيلًا. نفذ أوضاع مفصلة.

علاوة على ذلك، اختبر عبر الأنظمة الأساسية للتناسق.

تلخيص تطورات Ollama

تمثل واجهة برمجة تطبيقات البحث على الويب وخادم MCP من Ollama تقدمًا كبيرًا. يستفيد المطورون من هذه الميزات لتطبيقات قوية. مع المستويات المجانية ودعم عبر الأنظمة الأساسية، يتسارع التبني. استكشف المزيد، ادمج مع Apidog، وابنِ الجيل القادم من أدوات الذكاء الاصطناعي.

زر

ممارسة تصميم API في Apidog

اكتشف طريقة أسهل لبناء واستخدام واجهات برمجة التطبيقات