MCP Reference: developerknowledge.googleapis.com

يعمل خادم بروتوكول سياق النموذج (MCP) كخادم وكيل بين خدمة خارجية توفّر السياق أو البيانات أو الإمكانات لنموذج لغوي كبير (LLM) أو تطبيق ذكاء اصطناعي. تربط خوادم MCP تطبيقات الذكاء الاصطناعي بأنظمة خارجية، مثل قواعد البيانات وخدمات الويب، وتحوّل ردودها إلى تنسيق يمكن لتطبيق الذكاء الاصطناعي فهمه.

إعداد الخادم

يجب تفعيل خوادم MCP وإعداد المصادقة قبل الاستخدام. لمزيد من المعلومات حول استخدام خوادم MCP البعيدة من Google وGoogle Cloud، يُرجى الاطّلاع على نظرة عامة على خوادم MCP من Google Cloud.

نقاط نهاية الخادم

نقطة نهاية خدمة MCP هي عنوان الشبكة وواجهة الاتصال (عادةً ما تكون عنوان URL) لخادم MCP الذي يستخدمه تطبيق مستند إلى الذكاء الاصطناعي (المضيف لبرنامج MCP) لإنشاء اتصال آمن وموحّد. وهي نقطة التواصل التي يستخدمها النموذج اللغوي الكبير لطلب السياق أو استخدام أداة أو الوصول إلى مرجع. يمكن أن تكون نقاط نهاية Google MCP عالمية أو إقليمية.

يحتوي خادم MCP الخاص بواجهة Developer Knowledge API على نقطة نهاية MCP العامة التالية:

  • https://developerknowledge.googleapis.com/mcp

أدوات MCP

أداة MCP هي وظيفة أو إمكانية تنفيذية يعرضها خادم MCP لنموذج لغوي كبير أو تطبيق ذكاء اصطناعي لتنفيذ إجراء في العالم الحقيقي.

الأدوات

يتضمّن خادم MCP على developerknowledge.googleapis.com الأدوات التالية:

أدوات MCP
search_documents

استخدِم هذه الأداة للعثور على مستندات حول منتجات المطوّرين من Google. تحتوي المستندات على واجهات برمجة تطبيقات رسمية ومقتطفات من الرموز البرمجية وملاحظات الإصدار وأفضل الممارسات والأدلّة ومعلومات تصحيح الأخطاء وغير ذلك. ويشمل المنتجات والنطاقات التالية:

  • ADK: adk.dev

  • ‫Android: developer.android.com

  • Apigee: ‏ docs.apigee.com

  • Chrome: developer.chrome.com

  • ‫Dart: dart.dev

  • ‫Firebase: firebase.google.com

  • ‫Flutter: docs.flutter.dev

  • ‫Fuchsia: fuchsia.dev

  • ‫Gemini CLI: geminicli.com

  • Go: go.dev

  • Google AI: ai.google.dev

  • ‫Google Antigravity: antigravity.google

  • ‫Google Cloud: ‏ cloud.google.com وdocs.cloud.google.com

  • Google Developers و"إعلانات Google" و"بحث Google" و"خرائط Google" وYouTube: developers.google.com

  • ‫Google Home: developers.home.google.com

  • منصة خرائط Google: ‏ mapsplatform.google.com

  • ‫TensorFlow: www.tensorflow.org

  • الويب: web.dev

تعرض هذه الأداة أجزاء من النصوص والأسماء وعناوين URL للمستندات المطابقة. إذا لم تكن الأجزاء المعروضة مفصّلة بما يكفي للإجابة عن سؤال المستخدم، استخدِم get_documents مع parent من نتائج هذه الأداة لاسترداد محتوى المستند الكامل.
answer_query

استخدِم answer_query للحصول على إجابة مستندة إلى معلومات واقعية عن طلب بحث حول منتجات المطوّرين من Google. تتوفّر حصة محدودة من هذه الأداة. ستعمل هذه الأداة على تجميع المعلومات من مجموعة النصوص لإنشاء إجابة عن الاستعلام. تستند الإجابات التي تقدّمها answer_query إلى مجموعة النصوص نفسها التي تستخدمها search_documents. تعرض هذه الأداة النص الذي تم إنشاؤه للإجابة وقائمة بأسماء المستندات (المراجع) المستخدَمة لإنشاء الإجابة. استخدِم get_documents مع أسماء المستندات لجلب محتوى المستند بأكمله إذا لزم الأمر.

إذا ظهر لك الخطأ 429 بسبب تجاوز الحصة، استخدِم search_documents بدلاً من ذلك.
get_documents استخدِم هذه الأداة لاسترداد المحتوى الكامل لمستند واحد أو ما يصل إلى 20 مستندًا في طلب واحد. يجب الحصول على أسماء المستندات من الحقل parent في نتائج طلب إلى أداة search_documents. اضبط المَعلمة names على قائمة بأسماء المستندات.

الحصول على مواصفات أداة MCP

للحصول على مواصفات أداة MCP لجميع الأدوات في خادم MCP، استخدِم الطريقة tools/list. يوضّح المثال التالي كيفية استخدام curl لإدراج جميع الأدوات ومواصفاتها المتاحة حاليًا في خادم MCP.

طلب Curl 
                      
curl --location 'https://developerknowledge.googleapis.com/mcp' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
    "method": "tools/list",
    "jsonrpc": "2.0",
    "id": 1
}'