MCP Reference: people.googleapis.com

मॉडल कॉन्टेक्स्ट प्रोटोकॉल (एमसीपी) सर्वर, लार्ज लैंग्वेज मॉडल (एलएलएम) या एआई ऐप्लिकेशन को कॉन्टेक्स्ट, डेटा या सुविधाएं देने वाली बाहरी सेवा के बीच प्रॉक्सी के तौर पर काम करता है. एमसीपी सर्वर, एआई ऐप्लिकेशन को डेटाबेस और वेब सेवाओं जैसे बाहरी सिस्टम से कनेक्ट करते हैं. साथ ही, उनके जवाबों को ऐसे फ़ॉर्मैट में बदलते हैं जिसे एआई ऐप्लिकेशन समझ सके.

एमसीपी टूल

एमसीपी टूल एक फ़ंक्शन या एक्ज़ीक्यूटेबल क्षमता होती है. इसे एमसीपी सर्वर, एलएलएम या एआई ऐप्लिकेशन के लिए उपलब्ध कराता है, ताकि वह असल दुनिया में कोई कार्रवाई कर सके.

people.googleapis.com एमसीपी सर्वर में ये टूल मौजूद हैं:

एमसीपी टूल
search_directory_people

अपने संगठन की Google Workspace डायरेक्ट्री में लोगों को खोजें. यह सुविधा सिर्फ़ Google Workspace खातों के लिए उपलब्ध है. इनका इस्तेमाल कारोबार, स्कूल, और अन्य संगठन करते हैं. यह सुविधा, निजी Google खातों के लिए उपलब्ध नहीं है.

इन ज़रूरी नियमों का पालन करें:

  • अगर यह टूल कई नतीजे दिखाता है, तो आपको उपयोगकर्ता को नतीजे दिखाने चाहिए. साथ ही, आगे बढ़ने से पहले, उपयोगकर्ता से यह पूछना चाहिए कि उसे कौनसे नतीजे का इस्तेमाल करना है.

  • उपयोगकर्ता की पुष्टि के बिना, इस टूल के आउटपुट को किसी दूसरे टूल (जैसे, ईमेल भेजना, ड्राफ़्ट बनाना, इवेंट बनाना वगैरह) में इस्तेमाल करने की अनुमति नहीं है.

  • अगर खोज के नतीजे में सिर्फ़ एक व्यक्ति की जानकारी मिलती है, तो भी आपको उस व्यक्ति की जानकारी उपयोगकर्ता को दिखानी होगी. साथ ही, उपयोगकर्ता को यह पुष्टि करने के लिए कहना होगा कि यह वही व्यक्ति है जिसके बारे में वह जानकारी पाना चाहता है. इसके बाद ही, आगे की कार्रवाई की जा सकेगी.

  • अगर इस टूल से कोई नतीजा नहीं मिलता है, तो search_contacts टूल का इस्तेमाल करें.
search_contacts

उपयोगकर्ता के संपर्कों को खोजें.

इन ज़रूरी नियमों का पालन करें:

  • अगर यह टूल कई नतीजे दिखाता है, तो आपको उपयोगकर्ता को नतीजे दिखाने चाहिए. साथ ही, आगे बढ़ने से पहले, उपयोगकर्ता से यह पूछना चाहिए कि उसे कौनसे नतीजे का इस्तेमाल करना है.

  • उपयोगकर्ता की पुष्टि के बिना, इस टूल के आउटपुट को किसी दूसरे टूल (जैसे, ईमेल भेजना, ड्राफ़्ट बनाना, इवेंट बनाना वगैरह) में इस्तेमाल करने की अनुमति नहीं है.

  • अगर खोज के नतीजे में सिर्फ़ एक व्यक्ति की जानकारी मिलती है, तो भी आपको उस व्यक्ति की जानकारी उपयोगकर्ता को दिखानी होगी. साथ ही, उपयोगकर्ता को यह पुष्टि करने के लिए कहना होगा कि यह वही व्यक्ति है जिसके बारे में वह जानकारी पाना चाहता है. इसके बाद ही, आगे की कार्रवाई की जा सकेगी.
get_user_profile अपनी प्रोफ़ाइल की जानकारी (नाम और ईमेल) पाना.

एमसीपी टूल की खास जानकारी पाना

किसी एमसीपी सर्वर में मौजूद सभी टूल के लिए, एमसीपी टूल की खास जानकारी पाने के लिए, 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
}'