بروتوكول سياق النموذج - موصل Perplexity API

نظرة عامة على المشروع

بروتوكول سياق النموذج (Model Context Protocol - MCP) هو مشروع مبتكر لتنفيذ خادم مصمم خصيصًا لدمج واجهة برمجة تطبيقات Sonar الخاصة بـ Perplexity. الهدف الأساسي للمشروع هو تزويد المساعدين الذين يعملون بالذكاء الاصطناعي مثل Claude بقدرات بحث ويب في الوقت الفعلي لا مثيل لها، مما يسمح للمستخدمين بالحصول على أحدث المعلومات من الويب دون مغادرة نظام MCP البيئي.

عنوان المشروع: https://github.com/ppl-ai/modelcontextprotocol

الترخيص: MIT License

الوظائف والميزات الأساسية

🌐 بحث ويب في الوقت الفعلي

• تكامل Sonar API: دمج مباشر لمحرك البحث القوي الخاص بـ Perplexity.
• الحصول على معلومات في الوقت الفعلي: توفير أحدث وأدق المعلومات من الويب.
• تجربة سلسة: إكمال جميع عمليات البحث داخل نظام MCP البيئي.

🛠️ سهل الاستخدام للمطورين

• طرق نشر متعددة: يدعم النشر باستخدام حاويات Docker والتثبيت المباشر عبر NPM.
• دعم TypeScript: تم تطويره باستخدام TypeScript، مما يوفر أمانًا أفضل للأنواع.
• تكوين مرن: إمكانية تخصيص معلمات البحث وإعدادات استدعاء واجهة برمجة التطبيقات.

🔧 الأدوات والواجهات

أداة perplexity_ask

هذه الأداة هي الوظيفة الأساسية للمشروع، وتوفر القدرات التالية:

وصف الوظيفة: التفاعل الحواري مع Sonar API، لتحقيق بحث ويب في الوقت الفعلي.

معلمات الإدخال:

• messages (مصفوفة): مصفوفة رسائل المحادثة.
  • role (سلسلة نصية): دور الرسالة (مثل system أو user أو assistant).
  • content (سلسلة نصية): محتوى الرسالة.

🖥️ الأنظمة الأساسية المدعومة

Claude Desktop

• تكامل أصلي: دعم مثالي لتطبيق Claude لسطح المكتب.
• تكوين بسيط: يمكن تفعيله من خلال ملف تكوين JSON.
• تصور الأداة: يظهر رمز المطرقة في الواجهة، مما يشير إلى أن الأداة نشطة.

Cursor IDE

• تكامل بيئة التطوير: يدعم محرر الأكواد Cursor.
• خادم MCP عالمي: يمكن تكوينه كأداة متاحة عالميًا.
• سير عمل المطور: يندمج بسلاسة في سير العمل اليومي للمطورين.

بداية سريعة

تجهيز البيئة

1. الحصول على مفتاح API

   • سجل للحصول على حساب Sonar API.
   • قم بإنشاء مفتاح API من لوحة معلومات المطور.
   • قم بتعيين متغير البيئة PERPLEXITY_API_KEY.

2. تثبيت المشروع

   git clone git@github.com:ppl-ai/modelcontextprotocol.git
   cd modelcontextprotocol/perplexity-ask
   npm install
   

خيارات النشر

الخيار الأول: نشر Docker

{
  "mcpServers": {
    "perplexity-ask": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm", "-e", "PERPLEXITY_API_KEY",
        "mcp/perplexity-ask"
      ],
      "env": {
        "PERPLEXITY_API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}

الخيار الثاني: التشغيل المباشر عبر NPM

{
  "mcpServers": {
    "perplexity-ask": {
      "command": "npx",
      "args": ["-y", "server-perplexity-ask"],
      "env": {
        "PERPLEXITY_API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}

البنية التقنية

مكونات النظام

• خادم MCP: مكون الخدمة الأساسي، يعالج اتصالات البروتوكول.
• عميل Sonar API: طبقة الواجهة مع Perplexity API.
• معالج الرسائل: يعالج رسائل المحادثة وطلبات البحث.
• إدارة التكوين: نظام تكوين مرن للمعلمات.

تدفق البيانات

1. استقبال الطلب: يرسل Claude أو عميل آخر طلب بحث.
2. معالجة الرسائل: يقوم خادم MCP بتحليل رسائل المحادثة.
3. استدعاء API: يتم إرسال طلب بحث إلى Sonar API.
4. إرجاع النتائج: يتم إرجاع نتائج البحث في الوقت الفعلي إلى العميل.

حالات الاستخدام

📚 البحث والدراسة

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

💼 التطبيقات التجارية

• تحليل السوق: الحصول على أحدث اتجاهات السوق ومعلومات المنافسة.
• خدمة العملاء: تزويد العملاء بأحدث معلومات المنتج والحلول.
• إنشاء المحتوى: الحصول على أحدث المعلومات لإنشاء المحتوى.

🛠️ أدوات المطورين

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

التخصيص والتوسيع

تكوين معلمات البحث

يسمح المشروع للمطورين بتعديل معلمات البحث مباشرة في ملف index.ts، بما في ذلك:

• إعدادات وضع البحث
• قيود عدد النتائج
• إعدادات تفضيلات اللغة
• تصفية النطاق الزمني

مزايا المشروع

✅ مفتوح المصدر وشفاف

• ترخيص MIT: مفتوح المصدر بالكامل، ويمكن استخدامه وتعديله وتوزيعه بحرية.
• مدفوع بالمجتمع: نرحب بالمساهمين للمشاركة في تطوير المشروع.

✅ سهل الدمج

• بروتوكول موحد: يعتمد على معيار MCP، توافق قوي.
• دعم متعدد الأنظمة الأساسية: يدعم العديد من المساعدين الذين يعملون بالذكاء الاصطناعي وبيئات التطوير.

✅ قابل للتخصيص بدرجة عالية

• تكوين مرن: يدعم تخصيص معلمات البحث المختلفة.
• قابلية توسيع قوية: يمكن توسيع الوظائف وفقًا للاحتياجات.

ملخص

موصل بروتوكول سياق النموذج - Perplexity API هو مشروع مفتوح المصدر قوي وسهل الاستخدام، يوفر للمساعدين الذين يعملون بالذكاء الاصطناعي قدرات بحث ويب قوية في الوقت الفعلي. من خلال دمج Sonar API الخاص بـ Perplexity، يتيح هذا المشروع للمستخدمين الحصول على أحدث وأدق المعلومات من الويب دون مغادرة بيئة العمل الحالية.

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

الجمهور المستهدف:

• مطورو تطبيقات الذكاء الاصطناعي
• الباحثون والأكاديميون
• منشئو المحتوى
• مستخدمو الشركات الذين يحتاجون إلى معلومات في الوقت الفعلي

القيمة الأساسية:

• تحسين قدرة المساعدين الذين يعملون بالذكاء الاصطناعي على الحصول على المعلومات.
• تبسيط عملية دمج البحث في الوقت الفعلي.
• توفير مصدر موثوق ودقيق للمعلومات من الويب.