MCP Reference: calendarmcp.googleapis.com

זהו שרת MCP שמסופק על ידי Google Calendar API. השרת מספק למפתחים כלים לבניית אפליקציות LLM על בסיס יומן Google.

שרת Model Context Protocol‏ (MCP) פועל כשרת proxy בין שירות חיצוני שמספק הקשר, נתונים או יכולות למודל שפה גדול (LLM) או לאפליקציית AI. שרתי MCP מחברים אפליקציות AI למערכות חיצוניות כמו מסדי נתונים ושירותי אינטרנט, ומתרגמים את התשובות שלהם לפורמט שאפליקציית ה-AI יכולה להבין.

הגדרת השרת

לפני שמשתמשים בשרת ה-MCP של יומן Google, צריך להגדיר אותו. מידע נוסף על שימוש בשרתי MCP מרוחקים של Google ו-Google Cloud זמין במאמר סקירה כללית על שרתי Google Cloud MCP.

נקודות קצה של שרתים

נקודת קצה של שירות MCP היא כתובת הרשת וממשק התקשורת (בדרך כלל כתובת URL) של שרת ה-MCP, שמשמש יישום AI (המארח של לקוח ה-MCP) כדי ליצור חיבור מאובטח וסטנדרטי. הוא משמש כנקודת קשר למודל ה-LLM כדי לבקש הקשר, להפעיל כלי או לגשת למשאב. נקודות הקצה של Google MCP יכולות להיות גלובליות או אזוריות.

לשרת ה-MCP של Calendar API יש את נקודת הקצה הגלובלית הבאה של MCP:

  • https://calendarmcp.googleapis.com/mcp/v1

כלי MCP

כלי MCP הוא פונקציה או יכולת הפעלה ששרת MCP חושף למודל שפה גדול (LLM) או לאפליקציית AI כדי לבצע פעולה בעולם האמיתי.

כלים

לשרת ה-MCP ‏calendarmcp.googleapis.com יש את הכלים הבאים:

כלי MCP
list_events

מציג רשימה של אירועים ביומן מסוים שעומדים בתנאים שצוינו.

התכונות העיקריות:

  • כל מזהה יומן, שיכול להיות היומן הראשי של המשתמש או יומנים אחרים.
  • התאמה למילות מפתח.
  • סינון לפי טווח זמן.
  • מאחזר את כל האירועים שתואמים למגבלות הזמן ומילות המפתח.

אם אתם רוצים:

  • אתם צריכים למצוא את האירועים הרלוונטיים ביותר (ה-K העליונים) ולא את כל האירועים שעומדים באילוצים.
  • אתם צריכים יכולות של חיפוש סמנטי.
  • אתם מחפשים מידע ספציפי רק ביומן הראשי של המשתמש.

אפשר להשתמש בכלי הזה לשאילתות כמו:

  • מה האירועים ביומן שלי מחר?
  • מה האירועים שרשומים ביומן שלי ל-14 ביולי 2025?
  • What are my meetings next week?‎ (מה הפגישות שלי בשבוע הבא?)
  • יש לי פגישות שנקבעו בזמנים חופפים היום בצהריים?

דוגמה:

list_events(
    startTime='2024-09-17T06:00:00',
    endTime='2024-09-17T12:00:00',
    pageSize=10
)
# Returns up to 10 calendar events between 6:00 AM and 12:00 PM on September 17, 2024 from the user's primary calendar.
get_event

מחזירה אירוע יחיד מיומן נתון.

אפשר להשתמש בכלי הזה לשאילתות כמו:

  • קבלת פרטים על הפגישה של הצוות.
  • תציג לי את האירוע עם המזהה event123 ביומן שלי.

דוגמה:

get_event(
    eventId='event123'
)
# Returns the event details for the event with id `event123` on the user's primary calendar.
list_calendars

מחזירה את היומנים ברשימת היומנים של המשתמש.

אפשר להשתמש בכלי הזה לשאילתות כמו:

  • מהם כל היומנים שלי?

דוגמה:

list_calendars()
# Returns all calendars the authenticated user has access to.
suggest_time

מציע תקופות זמן בכמה יומנים. כדי לגשת ליומן הראשי, מוסיפים את הערך 'primary' בשדה attendee_emails.

אפשר להשתמש בכלי הזה לשאילתות כמו:

  • מתי לכולנו יש זמן לפגישה?
  • תמצא לי חלון זמן של 30 דקות שבו שנינו פנויים.
  • בודקים אם jane.doe@google.com פנויה ביום שני בבוקר.

דוגמה:

suggest_time(
    attendeeEmails=['joedoe@gmail.com', 'janedoe@gmail.com'],
    startTime='2024-09-10T00:00:00',
    endTime='2024-09-17T00:00:00',
    durationMinutes=60,
    preferences={
        'startHour': '09:00',
        'endHour': '17:00',
        'excludeWeekends': True
    }
)
# Returns up to 5 suggested time slots where both users are available for at least one hour between 9:00 AM and 5:00 PM on weekdays from September 10 through September 16, 2024.
create_event

יוצר אירוע ביומן.

אפשר להשתמש בכלי הזה לשאילתות כמו:

  • תצור אירוע ביומן שלי למחר בשעה 14:00 בשם 'פגישה עם דנה'.
  • קביעת פגישה עם john.doe@google.com ביום שני הבא בין השעות 10:00 ל-11:00.

דוגמה:

create_event(
    summary='Meeting with Jane',
    startTime='2024-09-17T14:00:00',
    endTime='2024-09-17T15:00:00'
)
# Creates an event on the primary calendar for September 17, 2024 from 2pm to 3pm called 'Meeting with Jane'.
update_event

מעדכן אירוע ביומן.

אפשר להשתמש בכלי הזה לשאילתות כמו:

  • תעדכן את האירוע 'פגישה עם יעל' לשעה מאוחר יותר.
  • תצרף את john.doe@google.com לפגישה מחר.

דוגמה:

update_event(
    eventId='event123',
    summary='Meeting with Jane and John'
)
# Updates the summary of event with id 'event123' on the primary calendar to 'Meeting with Jane and John'.
delete_event

מחיקת אירוע ביומן.

אפשר להשתמש בכלי הזה לשאילתות כמו:

  • תמחק את האירוע עם המזהה event123 ביומן שלי.

כדי לבטל או לדחות אירוע, צריך להשתמש בכלי respond_to_event.

דוגמה:

delete_event(
    eventId='event123'
)
# Deletes the event with id 'event123' on the user's primary calendar.
respond_to_event

שליחת תשובה להזמנה לאירוע.

אפשר להשתמש בכלי הזה לשאילתות כמו:

  • תאשר את האירוע עם המזהה event123 ביומן שלי.
  • תדחה את הפגישה עם ג'יין.
  • תבטל את הפגישה הבאה שלי.
  • לאשר זמנית את הפגישה לתכנון.

דוגמה:

respond_to_event(
    eventId='event123',
    responseStatus='accepted'
)
# Responds with status 'accepted' to the event with id 'event123' on the user's primary calendar.

קבלת מפרטים של כלי ה-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
}'