שימוש בשרת MCP מקומי של Backup and DR כדי להפעיל פעולות גיבוי באמצעות הנחיות בשפה טבעית

שרת Model Context Protocol‏ (MCP) המקומי של Backup and DR מאפשר לאסיסטנטי AI ולאפליקציות מבוססות-LLM לקיים אינטראקציה מאובטחת עם סביבת הגיבוי שלכם. הפעלת השרת באופן מקומי מאפשרת לכם להשתמש ב-AI גנרטיבי כדי לנהל משימות של גיבוי ושחזור (Backup and DR), כמו יצירת כספות גיבוי ותוכניות גיבוי או הפעלת התראות, באמצעות הנחיות בשפה טבעית, תוך שמירה על שליטה בסביבה המקומית. מידע נוסף על השימוש בשרתי MCP כדי ליצור אינטראקציה בין שירותים Google Cloud

שרת ה-MCP המקומי של Backup and DR משמש כגשר בין מארח שתואם ל-MCP (כמו Gemini CLI,‏ ChatGPT או Claude Code) לבין Google Cloud Backup and DR API.

מכיוון שהשרת פועל בתחנת העבודה שלכם, ה-AI יכול להשתמש בפרטי הכניסה המקומיים ובנתיב הרשת כדי לתקשר ישירות עם Google Cloud.

היתרונות של שרת MCP מקומי של Backup and DR:

  • ניהול מבוסס-AI: אפשר להשתמש בהנחיות בשפה טבעית כדי לבצע אוטומציה של משימות מורכבות של Backup and DR, ולפשט אותן.
  • אבטחה: הנתונים שלכם נשארים בגבולות שהגדרתם. השרת המקומי משתמש באימות הקיים של Google Cloud CLI.
  • פתרון בעיות פשוט יותר: המערכת מזהה כשלים בגיבוי ובשחזור של משימות, מתריעה על כך למשתמשים ומציעה פתרונות לתיקון השגיאות.
  • גילוי מרכזי: אינטראקציה בין מספר Google Cloud שירותים, כמו Cloud Monitoring,‏ Cloud Storage ו-BigQuery, באמצעות אותה סביבת MCP.

לפני שמתחילים

לפני שמגדירים את שרת ה-MCP המקומי ל-Backup and DR, צריך לוודא שיש לכם את הפריטים הבאים:

  • פרויקט ב-Google Cloud שמופעלים בו ממשקי ה-API של Backup and DR,‏ Compute Engine ו-Cloud SQL.
  • מארח MCP, כמו Gemini CLI.
  • סביבה מקומית עם הרכיבים הבאים:
    • ‫Node.js (גרסה 20 ואילך)
    • ה-SDK של Google Cloud ‏ (Google Cloud CLI) מופעל ומאומת.

ההרשאות הנדרשות

משתמשים צריכים הרשאות ותפקידים רלוונטיים בניהול הזהויות והרשאות הגישה (IAM) כדי לבצע את המשימות המתאימות באמצעות שרת MCP מקומי. לדוגמה:

  • ‫roles/backupdr.viewer (להרצת שאילתות לגבי פרטי המטא-נתונים והסטטוס)
  • ‫roles/backupdr.restoreUser (להפעלת שחזורים)

הגדרת שרת MCP מקומי

כדי להתקין את Gemini CLI ולהגדיר את שרת ה-MCP המקומי של Backup and DR, צריך לבצע את השלבים הבאים:

  1. התקנת Gemini CLI

    כדי לשלב את שרת ה-MCP המקומי של Backup and DR עם Gemini CLI או עם Gemini Code Assist, מריצים את פקודת ההגדרה הזו. הפעולה הזו תתקין את שרת ה-MCP כתוסף של Gemini CLI עבור המשתמש הנוכחי, והוא יהיה זמין לכל הפרויקטים.

    npm install -g @google/gemini-cli
    

    מידע נוסף זמין בכתובת https://geminicli.com/docs/get-started/installation.

  2. הגדרת שרת MCP מקומי של Backup and DR

    כדי להתקין את שרת ה-MCP של Backup and DR, מריצים את הפקודה הזו. כברירת מחדל, השרת מותקן ברמת הגישה READ_ONLY.

    npx @google-cloud/backupdr-mcp init --agent=gemini-cli
    

    אחרי תהליך ההתקנה, אפשר להריץ את הפקודה הבאה כדי לוודא שהשרת של Backup and DR MCP מוגדר בצורה נכונה:

    gemini mcp list
    

    הפלט אמור להציג סטטוס דומה לזה:

    > ✓ backupdr (from @google-cloud/backupdr-mcp): npx -y backupdr-mcp --access-level READ_ONLY (stdio) - Connected
    
  3. הגדרת שרת ה-MCP המקומי

    אפשר להתאים אישית את ההתנהגות של שרת ה-MCP באמצעות הדגלים הבאים.

    1. מגדירים את רמת הגישה.

      רמת הגישה קובעת אילו כלים יהיו זמינים לסוכן ה-AI.

      • דגל: --access-level
      • ערכים: READ_ONLY (ברירת מחדל), UPSERT, ALL

      • ‫READ_ONLY: מספק כלים לקריאה בלבד לגילוי ולבדיקה.

        npx @google-cloud/backupdr-mcp init --agent=gemini-cli --access-level=READ_ONLY
        
      • ‫UPSERT: מספק כלים לגילוי, לבדיקה, ליצירה ולעדכון (כולל שחזורים).

        npx @google-cloud/backupdr-mcp init --agent=gemini-cli --access-level=UPSERT
        
      • ALL: מספק את כל הכלים, כולל פעולות הרסניות כמו מחיקה.

        npx @google-cloud/backupdr-mcp init --agent=gemini-cli --access-level=ALL
        
    2. הגדרת קובץ ההקשר

    קבצים להקשר הם תכונה שימושית שמאפשרת לספק הקשר הדרכתי למודל Gemini. שרת ה-MCP של Backup and DR כולל מידע על הקשר לגבי השימוש בכלים ובתהליכי עבודה נפוצים.

    • דגל: --overwrite-context-file
    • ערכים: true, false (ברירת מחדל)
    • מיקום: ~/.gemini/backupdr-mcp/GEMINI.md

    כברירת מחדל, קובץ ההקשר נוצר רק אם הוא עדיין לא קיים. כדי להתקין את שרת ה-MCP על ידי החלפת קובץ ההקשר, מריצים את הפקודה הבאה:

    npx @google-cloud/backupdr-mcp init --agent=gemini-cli --overwrite-context-file=true
    

    אם --overwrite-context-file מוגדר כ-False, בהתקנת תוסף ייווצר ההקשר רק אם הוא עדיין לא קיים בספרייה.

    כדי להתקין את שרת ה-MCP המקומי בלי להחליף את קובץ ההקשר, מריצים את הפקודה הבאה:

    npx @google-cloud/backupdr-mcp init --agent=gemini-cli --overwrite-context-file=false
    

    מידע נוסף זמין במאמר בנושא מתן הקשר באמצעות קובצי GEMINI.md.

  4. הגדרת אימות והרשאה של משתמשים

    שרת ה-MCP משתמש ב-Application Default Credentials ‏ (ADC) כדי לבצע פעולות. בדיקות IAM שרלוונטיות לשירות Backup and DR מתבצעות ב-ADC. מידע נוסף על Application Default Credentials זמין במאמר בנושא הגדרה של Application Default Credentials.

    1. כדי להגדיר את פרטי הכניסה, מריצים את הפקודה הבאה:

      gcloud auth application-default login
      
    2. כדי להשתמש בפרטי כניסה של חשבון שירות במקום בפרטי הכניסה שלכם, אתם יכולים להתחזות לחשבון שירות באמצעות Application Default Credentials ‏ (ADC). כדי להתחזות לחשבון שירות, מריצים את הפקודה הבאה:

      gcloud auth application-default login --impersonate-service-account [SERVICE_ACCOUNT_EMAIL]
      

כלים זמינים

שרת ה-MCP המקומי של Backup and DR כולל את הכלים הבאים.

כלים לקריאה בלבד

הכלים האלה מאפשרים לגלות ולבדוק משאבים של Backup and DR בלי לאפשר עריכה.

כלי תיאור
list_backup_vaults הצגת רשימה של כל כספות הגיבוי בפרויקט ובמיקום.
get_backup_vault קבלת פרטים של כספת גיבוי ספציפית.
list_backup_plans הצגת רשימה של כל תוכניות הגיבוי בפרויקט ובמיקום.
get_backup_plan קבלת פרטים של תוכנית גיבוי ספציפית.
list_backup_plan_associations רשימה של כל השיוכים בין תוכניות גיבוי למשאבים.
get_backup_plan_association מקבל פרטים של שיוך ספציפי לתוכנית גיבוי.
list_datasources הצגת רשימה של כל מקורות הנתונים בכספת הגיבוי.
get_datasource קבלת פרטים של מקור נתונים ספציפי.
list_backups מציג רשימה של כל הגיבויים של מקור נתונים מסוים.
get_backup קבלת פרטים של גיבוי ספציפי.
find_protectable_resources מגלה משאבים (מכונות וירטואליות, דיסקים, SQL) שאפשר להגן עליהם.
get_backupdr_operation אחזור הסטטוס של פעולה ממושכת של Backup and DR.
get_csql_operation אחזור הסטטוס של פעולה ממושכת ב-Cloud SQL.

כלי Upsert

הכלים האלה מאפשרים ליצור ולעדכן משאבים, כולל פעולות שחזור.

כלי תיאור
create_backup_vault יצירת כספת גיבוי חדשה במיקום שצוין.
create_backup_plan יצירת תוכנית גיבוי חדשה עם כללים ותקופת שמירה.
update_backup_plan שינוי של תוכנית גיבוי קיימת.
create_backup_plan_association משייכים משאב לתוכנית גיבוי.
restore_backup משחזרים גיבוי למכונה או לדיסק יעד של Compute Engine.
csql_restore משחזר גיבוי של Cloud SQL למכונת יעד.

מחיקת כלים

הכלים האלה כוללים את האפשרות למחוק משאבים. אפשר להפעיל אותן רק כשצריך, על ידי הגדרת רמת הגישה ל-ALL.

כלי תיאור
delete_backup_vault מחיקת כספת גיבוי.
delete_backup_plan מחיקה של תוכנית גיבוי.
delete_backup_plan_association הסרת ההגנה ממשאב.
delete_backup מחיקה של גיבוי ספציפי מכספת.

הנחיות לדוגמה

אחרי שהשרת מחובר, אפשר להשתמש בהנחיות בשפה טבעית בלקוח ה-AI כדי לנהל את סביבת הגיבוי.

  • הערכת תקינות הגיבוי בפרויקט

    Show the list of unprotected resources in project PROJECT_ID for region LOCATION.
    

    מחליפים את מה שכתוב בשדות הבאים:

    • ‫PROJECT_ID: מזהה הפרויקט שבו רוצים לבדוק את תקינות הגיבוי.
    • ‫LOCATION: האזור שבו נמצאים המשאבים.
  • יצירת מאגר גיבוי ותוכנית גיבוי

    Create a backup vault named VAULT_NAME in LOCATION to protect resource RESOURCE_NAME using backup plan PLAN_NAME.
    

    מחליפים את מה שכתוב בשדות הבאים:

    • ‫VAULT_NAME: השם של כספת הגיבוי החדשה.
    • ‫LOCATION: האזור שבו רוצים ליצור את הכספת.
    • ‫RESOURCE_NAME: שם המשאב שרוצים להגן עליו.
    • ‫PLAN_NAME: השם של תוכנית הגיבוי שרוצים להחיל.
  • ביקורת על גיבויים לצורך תאימות

    Audit all backups in the project PROJECT_ID in the region LOCATION. Once the audit is complete, compare the findings against my corporate backup policy to identify any compliance gaps.
    

    מחליפים את מה שכתוב בשדות הבאים:

    • ‫PROJECT_ID: מזהה הפרויקט שרוצים לבדוק.
    • ‫LOCATION: האזור שרוצים לבדוק.
  • ניתוח שורש הבעיה של כשלים

    בהנחיה הזו צריך להשתמש בכלי observability. הוראות להתקנת כלי MCP זמינות במאמר Available MCP Tools ב-GitHub.

    Identify and investigate the root cause of the resource RESOURCE_NAME backup failure in the last DURATION days in project PROJECT_ID.
    

    מחליפים את מה שכתוב בשדות הבאים:

    • ‫RESOURCE_NAME: השם של המשאב עם כשלים בגיבוי.
    • ‫DURATION: חלון הזמן של החקירה (לדוגמה, 7).
    • ‫PROJECT_ID: מזהה הפרויקט שבו אירעה הכשל.
  • שחזור גיבוי

    Restore the last successful backup for resource RESOURCE_NAME from project PROJECT_ID. Name the restored instance NEW_INSTANCE_NAME.
    

    מחליפים את מה שכתוב בשדות הבאים:

    • ‫RESOURCE_NAME: שם המשאב לשחזור.
    • ‫PROJECT_ID: מזהה הפרויקט שמכיל את הגיבוי.
    • ‫NEW_INSTANCE_NAME: שם למכונה המשוחזרת.
  • יצירת מדיניות התראות

    אפשר להפעיל התראות לכל שילוב של יומנים ומסננים שנוספו.

    בהנחיה הזו צריך להשתמש בכלי gcloud. הוראות להתקנת כלי MCP זמינות במאמר Available MCP Tools ב-GitHub.

    Create a log-based alert policy named ALERT_NAME to trigger on any log entry from `backupdr.googleapis.com` with severity `ERROR`. Send notification of the alerts immediately to EMAIL_ADDRESS.
    

    מחליפים את מה שכתוב בשדות הבאים:

    • ALERT_NAME: שם למדיניות ההתראות החדשה.
    • ‫EMAIL_ADDRESS: כתובת האימייל לקבלת התראות.

גישה לשרת באמצעות לקוחות AI אחרים

אפשר להשתמש בשרת MCP של Backup and DR עם לקוחות אחרים.

  • כדי לעשות זאת, מוסיפים את קטע הקוד הבא לקובצי התצורה המתאימים בפורמט JSON:

    "backupdr": {
      "command": "npx",
      "args": ["-y", "@google-cloud/backupdr-mcp"]
    }
    

הוראות לשימוש בכלי UEM נפוצים:

  • ‫Claude Desktop: פותחים את Claude > הגדרות > מפתח > עריכת ההגדרה ועורכים את claude_desktop_config.json.
  • ‫Cline: לוחצים על סמל שרתי ה-MCP ואז על 'הגדרת שרתי MCP' כדי לערוך את cline_mcp_settings.json.
  • סמן: עריכה .cursor/mcp.json של פרויקט יחיד או ~/.cursor/mcp.json של כל הפרויקטים.
  • ‫Gemini CLI (הגדרה ידנית): אם לא משתמשים בתוספים, עורכים את .gemini/settings.json לפרויקט יחיד או את ~/.gemini/settings.json לכל הפרויקטים.

  • ב-Visual Studio Code, עורכים את הקובץ .vscode/mcp.json בסביבת העבודה של פרויקט יחיד או את קובץ הגדרות המשתמש הגלובליות של כל הפרויקטים:

    "servers": {
      "backupdr": {
        "command": "npx",
        "args": ["-y", "@google-cloud/backupdr-mcp"]
      }
    }
    

כתב ויתור

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

המאמרים הבאים