זהו שרת MCP שסופק על ידי Google Calendar API. השרת מספק למפתחים כלים לבניית אפליקציות LLM על בסיס יומן Google.
שרת Model Context Protocol (MCP) פועל כפרוקסי בין שירות חיצוני שמספק הקשר, נתונים או יכולות למודל שפה גדול (LLM) או לאפליקציית AI. שרתי MCP מחברים אפליקציות AI למערכות חיצוניות כמו מסדי נתונים ושירותי אינטרנט, ומתרגמים את התשובות שלהם לפורמט שאפליקציית ה-AI יכולה להבין.
הגדרת השרת
לפני שמשתמשים בשרת ה-MCP של היומן, צריך להגדיר אותו. מידע נוסף על שימוש בשרתי MCP מרוחקים של Google ו-Google Cloud זמין במאמר סקירה כללית על שרתי MCP של Google Cloud.
נקודות קצה של שרתים
נקודת קצה של שירות MCP היא כתובת הרשת וממשק התקשורת (בדרך כלל כתובת URL) של שרת ה-MCP, שמשמשת אפליקציית AI (המארח של לקוח ה-MCP) כדי ליצור חיבור מאובטח וסטנדרטי. הוא משמש כנקודת קשר למודל ה-LLM כדי לבקש הקשר, להפעיל כלי או לגשת למשאב. נקודות הקצה של Google MCP יכולות להיות גלובליות או אזוריות.
ל-Calendar MCP API יש את נקודת הקצה הגלובלית הבאה של MCP:
- https://calendarmcp.googleapis.com/mcp/v1
כלי MCP
כלי MCP הוא פונקציה או יכולת הפעלה ששרת MCP חושף למודל שפה גדול (LLM) או לאפליקציית AI כדי לבצע פעולה בעולם האמיתי.
כלים
לשרת ה-MCP calendarmcp.googleapis.com יש את הכלים הבאים:
| כלי MCP | |
|---|---|
list_events |
מחזירה אירועים ביומן הנתון שתואמים לכל האילוצים שצוינו. אין לציין מגבלות זמן אלא אם המשתמש ביקש זאת. לחיפושים פתוחים של מילות מפתח או חיפושים שמבוססים על נושאים ביומן הראשי, צריך להשתמש בכלי search_events. |
get_event |
מחזירה אירוע יחיד ביומן הנתון. |
list_calendars |
מחזירה את היומנים שלמשתמש הזה יש גישה אליהם (רשימת היומנים שלו). אפשר להשתמש בכלי הזה כדי לזהות נתונים ביומן (לדוגמה, 'היומן המשפחתי שלי') ולמצוא את calendar_id (מזהה האימייל) שמתאים להם.
|
suggest_time |
מציע תקופות זמן בכמה יומנים. |
create_event |
יוצר אירוע ביומן שצוין. |
update_event |
מעדכן אירוע ביומן שצוין. |
delete_event |
מוחק אירוע ביומן שצוין. |
respond_to_event |
שליחת תשובה להזמנה לאירוע ביומן. |
search_events |
חיפוש אירועים ביומן הראשי של המשתמש באמצעות חיפוש סמנטי. |
קבלת מפרטים של כלי ה-MCP
כדי לקבל את המפרטים של כלי ה-MCP לכל הכלים בשרת MCP, משתמשים בשיטה tools/list. בדוגמה הבאה אפשר לראות איך משתמשים ב-curl כדי להציג רשימה של כל הכלים והמפרטים שלהם שזמינים כרגע בשרת ה-MCP.
| בקשת 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 }' |