MCP Reference: people.googleapis.com

People API एमसीपी सर्वर

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

सर्वर का सेटअप

People API का इस्तेमाल करने से पहले, आपको People API के एमसीपी सर्वर को कॉन्फ़िगर करना होगा. Google और Google Cloud के रिमोट एमसीपी सर्वर इस्तेमाल करने के बारे में ज़्यादा जानने के लिए, Google Cloud के एमसीपी सर्वर की खास जानकारी देखें.

सर्वर एंडपॉइंट

एमसीपी सेवा एंडपॉइंट, एमसीपी सर्वर का नेटवर्क पता और कम्यूनिकेशन इंटरफ़ेस (आम तौर पर एक यूआरएल) होता है. इसका इस्तेमाल, एआई ऐप्लिकेशन (एमसीपी क्लाइंट के लिए होस्ट) एक सुरक्षित और स्टैंडर्ड कनेक्शन बनाने के लिए करता है. यह एलएलएम के लिए संपर्क बिंदु है. इससे एलएलएम, कॉन्टेक्स्ट का अनुरोध कर सकता है, किसी टूल को कॉल कर सकता है या किसी संसाधन को ऐक्सेस कर सकता है. Google MCP के एंडपॉइंट, ग्लोबल या रीजनल हो सकते हैं.

People API के एमसीपी सर्वर का ग्लोबल एमसीपी एंडपॉइंट यह है:

https://people.googleapis.com/mcp/v1

People API का एमसीपी सर्वर, एमसीपी टूलसेट का यह एंडपॉइंट उपलब्ध कराता है:

https://people.googleapis.com/mcp/v1

एमसीपी टूल

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

टूलसेट

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

एमसीपी टूलसेट
एंडपॉइंट	ब्यौरा	टूल
/mcp/v1	People API के लिए एमसीपी टूल	`search_directory_people 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 }'

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
}'