MCP Reference: maintenance.googleapis.com

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

הגדרת השרת

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

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

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

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

  • https://maintenance.googleapis.com/mcp

כלי MCP

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

כלים

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

כלי MCP
list_resource_maintenances

מציג רשימה של פעולות תחזוקה של משאבים בפרויקט ובמיקום נתונים.

פרמטרים

  • ‫parent (מחרוזת, חובה): ההורה של תחזוקת המשאב, בפורמט projects/{project}/locations/{location}.
  • ‫page_size (מספר שלם, אופציונלי): המספר המקסימלי של פעולות תחזוקה של משאבים לשליחה בכל דף.
  • ‫page_token (מחרוזת, אופציונלי): טוקן של דף שהתקבל מקריאה קודמת של ListResourceMaintenances.
  • ‫filter (מחרוזת, אופציונלי): סינון הרשימה בהתאם להגדרה בכתובת https://google.aip.dev/160.
  • ‫order_by (string, אופציונלי): סדר התוצאות, כפי שמפורט בכתובת https://google.aip.dev/132.

ערך מוחזר

השיטה מחזירה אובייקט ListResourceMaintenancesResponse, שמכיל:

  • ‫resource_maintenances: רשימה של פעולות תחזוקה של משאבים שתואמות לקריטריונים של הבקשה.
  • ‫next_page_token: אסימון שאפשר לשלוח כ-page_token בבקשה הבאה כדי לאחזר את דף התוצאות הבא.

הערות

  • כדי לקבל תצוגה גלובלית בכל האזורים, משתמשים ב-'-' כמיקום.
get_resource_maintenance

אחזור פרטים על תחזוקת משאב ספציפי.

פרמטרים

  • ‫name (מחרוזת, חובה): שם המשאב של המשאב בשירות, בפורמט projects/{project}/locations/{location}/resourceMaintenances/{resource_maintenance_id}.

ערך מוחזר

אובייקט המשאב ResourceMaintenance אם הוא נמצא.
summarize_maintenances

מסכם את פעולות התחזוקה של פרויקט ומיקום מסוימים באמצעות נתונים סטטיסטיים מצטברים.

פרמטרים

  • ‫parent (מחרוזת, חובה): ההורה של תחזוקת המשאב, בפורמט projects/{project}/locations/{location}.
  • ‫page_size (מספר שלם, אופציונלי): המספר המקסימלי של פעולות תחזוקה של משאבים לשליחה בכל דף.
  • ‫page_token (מחרוזת, אופציונלי): טוקן של דף שהתקבל מקריאה קודמת של SummarizeMaintenances.
  • ‫filter (מחרוזת, אופציונלי): סינון הרשימה בהתאם להגדרה בכתובת https://google.aip.dev/160.
  • ‫order_by (string, אופציונלי): סדר התוצאות, כפי שמפורט בכתובת https://google.aip.dev/132.

ערך מוחזר

השיטה מחזירה אובייקט SummarizeMaintenancesResponse, שמכיל:

  • ‫maintenances: רשימה של סיכומי תחזוקה.
  • ‫next_page_token: אסימון שאפשר לשלוח כ-page_token בבקשה הבאה כדי לאחזר את דף התוצאות הבא.

הערות

  • כדי ליצור סיכום גלובלי של כל האזורים, משתמשים ב-'-' בתור מיקום.

קבלת מפרטים של כלי ה-MCP

כדי לקבל את המפרטים של כלי ה-MCP לכל הכלים בשרת MCP, משתמשים בשיטה tools/list. בדוגמה הבאה אפשר לראות איך משתמשים ב-curl כדי להציג רשימה של כל הכלים והמפרטים שלהם שזמינים כרגע בשרת MCP.

בקשת Curl 
                      
curl --location 'https://maintenance.googleapis.com/mcp' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
    "method": "tools/list",
    "jsonrpc": "2.0",
    "id": 1
}'