MCP Reference: people.googleapis.com

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

أدوات MCP

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

يتضمّن خادم MCP الخاص بـ people.googleapis.com الأدوات التالية:

أدوات MCP
search_directory_people

البحث عن مستخدمين ضمن دليل Google Workspace الخاص بمؤسستك تتوفّر هذه الميزة حصريًا لحسابات Google Workspace (التي تستخدمها الأنشطة التجارية والمؤسسات التعليمية والمؤسسات الأخرى)، ولا تتوفّر لحسابات Google الشخصية.

قواعد مهمة يجب اتّباعها:

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

  • يُحظر تمامًا نقل نتائج هذه الأداة إلى أداة أخرى (مثل إرسال رسالة إلكترونية أو إنشاء مسودة أو إنشاء حدث أو غير ذلك) بدون تأكيد صريح من المستخدم.

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

  • إذا لم تعرض هذه الأداة أي نتائج، يمكنك استخدام أداة search_contacts كحلّ بديل.
search_contacts

البحث في جهات اتصال المستخدم

قواعد مهمة يجب اتّباعها:

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

  • يُحظر تمامًا نقل نتائج هذه الأداة إلى أداة أخرى (مثل إرسال رسالة إلكترونية أو إنشاء مسودة أو إنشاء حدث أو غير ذلك) بدون تأكيد صريح من المستخدم.

  • حتى إذا تم العثور على نتيجة واحدة فقط لشخص، عليك عرض تفاصيل الشخص الذي تم العثور عليه للمستخدم ومطالبته بالتأكّد من أنّ هذا هو الشخص المقصود قبل المتابعة إلى الخطوات التالية.
get_user_profile الحصول على معلومات الملف الشخصي عنك (الاسم وعنوان البريد الإلكتروني)

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

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

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