यह Google Calendar API का एमसीपी सर्वर है. यह सर्वर, डेवलपर को Calendar पर एलएलएम ऐप्लिकेशन बनाने के लिए टूल उपलब्ध कराता है.
एक मॉडल कॉन्टेक्स्ट प्रोटोकॉल (एमसीपी) सर्वर, लार्ज लैंग्वेज मॉडल (एलएलएम) या एआई ऐप्लिकेशन को कॉन्टेक्स्ट, डेटा या सुविधाएं उपलब्ध कराने वाली किसी बाहरी सेवा के बीच प्रॉक्सी के तौर पर काम करता है. एमसीपी सर्वर, एआई ऐप्लिकेशन को डेटाबेस और वेब सेवाओं जैसे बाहरी सिस्टम से कनेक्ट करते हैं. साथ ही, उनके जवाबों को ऐसे फ़ॉर्मैट में ट्रांसलेट करते हैं जिसे एआई ऐप्लिकेशन समझ सके.
सर्वर का सेटअप
Calendar के एमसीपी सर्वर को इस्तेमाल करने से पहले, आपको इसे कॉन्फ़िगर करना होगा. Google और Google Cloud के रिमोट एमसीपी सर्वर इस्तेमाल करने के बारे में ज़्यादा जानने के लिए, Google Cloud के एमसीपी सर्वर की खास जानकारी देखें.
सर्वर के एंडपॉइंट
एमसीपी सेवा का एंडपॉइंट, एमसीपी सर्वर का नेटवर्क पता और कम्यूनिकेशन इंटरफ़ेस (आम तौर पर, एक यूआरएल) होता है. इसका इस्तेमाल, एआई ऐप्लिकेशन (एमसीपी क्लाइंट का होस्ट) सुरक्षित और स्टैंडर्ड कनेक्शन बनाने के लिए करता है. यह एलएलएम के लिए संपर्क करने का पॉइंट होता है. इसकी मदद से, एलएलएम कॉन्टेक्स्ट का अनुरोध कर सकता है, किसी टूल को कॉल कर सकता है या किसी संसाधन को ऐक्सेस कर सकता है. Google के एमसीपी एंडपॉइंट, ग्लोबल या रीजनल हो सकते हैं.
Calendar के एमसीपी एपीआई का ग्लोबल एमसीपी एंडपॉइंट यह है:
- https://calendarmcp.googleapis.com/mcp/v1
एमसीपी टूल
एक एमसीपी टूल, एक फ़ंक्शन या एक्ज़ीक्यूटेबल सुविधा होती है. इसे एमसीपी सर्वर, एलएलएम या एआई ऐप्लिकेशन को उपलब्ध कराता है, ताकि वह असल दुनिया में कोई कार्रवाई कर सके.
टूल
calendarmcp.googleapis.com के एमसीपी सर्वर में ये टूल शामिल हैं:
| एमसीपी टूल | |
|---|---|
list_events |
दिए गए कैलेंडर पर, बताई गई सभी शर्तों के मुताबिक इवेंट दिखाता है. समय की पाबंदी के बारे में तब तक नहीं बताना चाहिए, जब तक उपयोगकर्ता इसकी मांग न करे. मुख्य कैलेंडर पर, कीवर्ड या विषय के आधार पर खोज करने के लिए, search_events टूल का इस्तेमाल करना चाहिए. |
get_event |
दिए गए कैलेंडर पर, एक इवेंट दिखाता है. |
list_calendars |
उन कैलेंडर को दिखाता है जिनका ऐक्सेस इस उपयोगकर्ता के पास है. इसे उपयोगकर्ता की कैलेंडर सूची भी कहा जाता है. कैलेंडर की पहचान करने वाले डेटा (उदाहरण के लिए, 'मेरा फ़ैमिली कैलेंडर') को उसके calendar_id (ईमेल आइडेंटिफ़ायर) में बदलने के लिए, इस टूल का इस्तेमाल करें
|
suggest_time |
एक या एक से ज़्यादा कैलेंडर के लिए, समय के सुझाव देता है. |
create_event |
दिए गए कैलेंडर पर एक इवेंट बनाता है. |
update_event |
दिए गए कैलेंडर पर किसी इवेंट को अपडेट करता है. |
delete_event |
दिए गए कैलेंडर पर किसी इवेंट को मिटाता है. |
respond_to_event |
कैलेंडर पर किसी इवेंट का जवाब देता है. |
search_events |
सिमैंटिक खोज का इस्तेमाल करके, उपयोगकर्ता के मुख्य कैलेंडर पर इवेंट खोजता है. |
एमसीपी टूल की खास जानकारी पाना
किसी एमसीपी सर्वर में मौजूद सभी टूल के लिए, एमसीपी टूल की खास जानकारी पाने के लिए, tools/list तरीके का इस्तेमाल करें. यहां दिए गए उदाहरण में, curl का इस्तेमाल करके, एमसीपी सर्वर में फ़िलहाल उपलब्ध सभी टूल और उनकी खास जानकारी की सूची बनाने का तरीका बताया गया है.
| कर्ल का अनुरोध |
|---|
curl --location 'https://calendarmcp.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 }' |