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

  • ‫Genkit: ‏ genkit.dev

  • ‫Go: ‏ go.dev

  • تكنولوجيات الذكاء الاصطناعي من Google‏: 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

  • ‫Google Workspace: ‏ knowledge.workspace.google.com

  • ‫TensorFlow: ‏ www.tensorflow.org

  • الويب: web.dev

تعرض هذه الأداة أجزاء من النصوص والأسماء ومعرّفات الموارد المنتظمة (URI) للمستندات المطابقة. يُفضَّل استخدام search_documents متبوعًا بـ get_documents عندما تحتاج إلى عينات تعليمات برمجية دقيقة أو علامات واجهة سطر الأوامر (CLI) أو رسائل خطأ محدّدة أو جولات تفصيلية كاملة أو بحث حتمي عن الكلمات الرئيسية. إذا لم تكن الأجزاء المعروضة مفصّلة بما يكفي للإجابة عن سؤال المستخدم، استخدِم get_documents مع parent من نتائج هذه الأداة لاسترداد محتوى المستند بالكامل. عند الإجابة على المستخدم، يجب دائمًا ذكر أسماء مراجع المستندات المصدر الموثوقة (documents/...) أو معرّفات الموارد المنتظمة (URI).
answer_query

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

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

الحصول على مواصفات أداة 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
}'