חיבור מודלים של LLM ל-Cloud Storage באמצעות MCP

במדריך הזה מוסבר איך לחבר את Cloud Storage לסביבות פיתוח משולבות (IDE) ולכלי פיתוח. כדי לעשות זאת, מריצים שרת MCP מקומי במחשב באמצעות MCP Toolbox for Databases.

‫MCP Toolbox for Databases הוא מאגר קוד פתוח שמכיל מחברים למסדי נתונים ולמאגרי נתונים, כולל Cloud Storage,‏ BigQuery,‏ AlloyDB,‏ Spanner ו-Cloud SQL. ערכת הכלים תומכת באימות OAuth2 ו-OIDC, ומשתלבת עם Open Telemetry לצורך ניראות (observability). השילוב של ארגז הכלים של Cloud Storage מאפשר לכם להשתמש ב-LLM כדי לבצע את הפעולות הבאות:

  • יצירה, הצגה ומחיקה של קטגוריות.
  • אחזור מטא-נתונים של קטגוריות ואובייקטים.
  • קבלת מדיניות ניהול הזהויות והרשאות הגישה (IAM) בדליים.
  • קריאה, כתיבה, העלאה והורדה של אובייקטים.
  • מעתיקים או מעבירים אובייקטים.

במדריך הזה מוצג תהליך החיבור לכלי ולסביבות הפיתוח המשולבות (IDE) הבאים:

  • סמן
  • ‫Windsurf (לשעבר Codeium)
  • קוד Visual Studio ‏ (Copilot)
  • ‫Cline (תוסף ל-VS Code)
  • ‫Claude למחשב
  • Claude code
  • Antigravity

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

  1. בדף project selector במסוף Google Cloud , בוחרים פרויקט ב- Google Cloud או יוצרים אותו.

  2. מוודאים שהחיוב מופעל בפרויקט Google Cloud .

  3. מפעילים את Cloud Storage API ב Google Cloud פרויקט.

  4. מגדירים את התפקידים וההרשאות הנדרשים כדי לבצע את המשימה הזו. למשתמש שמפעיל את סוכני ה-LLM צריכים להיות התפקידים הבאים ברמת הקטגוריה או הפרויקט:

    • כדי להציג רשימה של קטגוריות, ליצור קטגוריות ולמחוק קטגוריות ריקות: אדמין לניהול אחסון (roles/storage.admin)
    • כדי להציג רשימה של אובייקטים, לקרוא אובייקטים, לקבל מטא-נתונים של אובייקטים או מטא-נתונים של קטגוריות: צפייה באובייקט אחסון (roles/storage.objectViewer)
    • כדי לכתוב תוכן לאובייקט או להעלות אובייקט: יצירת אובייקטים באחסון (roles/storage.objectCreator)
    • כדי להעתיק, להעביר או למחוק אובייקטים: אדמין של אובייקטים באחסון (roles/storage.objectAdmin)

  5. מגדירים Application Default Credentials (ADC) לסביבה שלכם.

התחברות ל-Antigravity

אתם מקשרים את Cloud Storage ל-Antigravity באמצעות הגדרה בהתאמה אישית. בהקשר הזה, שרת MCP בהתאמה אישית הוא שרת שאתם מגדירים באופן ידני על ידי עריכת קובץ ההגדרות (למשל mcp_config.json). ההגדרה הידנית הזו משמשת במקום התקנת השרת ישירות מקטלוג חנות ה-MCP המובנה.

כדי להגדיר שרת MCP בהתאמה אישית:

  1. כדי לוודא ש-npx מותקן ומוגדר בצורה נכונה במערכת, מריצים את הפקודה npx --version במסוף. אם אתם צריכים להתקין את Node.js, שכולל את npx, תוכלו להיעזר במדריך של npm בנושא הורדה והתקנה של Node.js ו-npm.
  2. פותחים את Antigravity ועוברים לחנות MCP באמצעות התפריט הנפתח '...' בחלק העליון של חלונית הסוכן בכלי העריכה.
  3. כדי לפתוח את הקובץ mcp_config.json, לוחצים על MCP Servers ואז על Manage MCP Servers > View raw config.
  4. מוסיפים את ההגדרה הבאה, מחליפים את ה-placeholder במזהה הפרויקט ושומרים: 
    {
  "mcpServers": {
    "storage": {
      "command": "npx",
      "args": ["-y","@toolbox-sdk/server","--prebuilt","cloud-storage","--stdio"],
      "env": {
          "CLOUD_STORAGE_PROJECT": "PROJECT_ID"
      }
    }
  }
}

התקנת MCP Toolbox

ערכת הכלים היא שרת Model Context Protocol‏ (MCP) בקוד פתוח שפועל באופן מקומי במחשב שלכם. השרת המקומי מנהל את התקשורת בין סביבת הפיתוח המשולבת לבין Cloud Storage. החיבור הזה מספק סביבה מאובטחת ויעילה לשימוש בכלי ה-AI.

  1. מורידים את הגרסה האחרונה של MCP Toolbox כקובץ בינארי. בוחרים את הקובץ הבינארי שמתאים למערכת ההפעלה ולארכיטקטורת ה-CPU. צריך להשתמש בגרסה 1.2.0 ואילך של MCP Toolbox:

    ‫linux/amd64

    curl -O https://storage.googleapis.com/mcp-toolbox-for-databases/VERSION/linux/amd64/toolbox

    מחליפים את VERSION בגרסה של MCP Toolbox. לדוגמה, v1.2.0.

    ‫macOS darwin/arm64

    curl -O https://storage.googleapis.com/mcp-toolbox-for-databases/VERSION/darwin/arm64/toolbox

    מחליפים את VERSION בגרסה של MCP Toolbox. לדוגמה, v1.2.0.

    ‫macOS darwin/amd64

    curl -O https://storage.googleapis.com/mcp-toolbox-for-databases/VERSION/darwin/amd64/toolbox

    מחליפים את VERSION בגרסה של MCP Toolbox. לדוגמה, v1.2.0.

    windows/amd64

    curl -O https://storage.googleapis.com/mcp-toolbox-for-databases/VERSION/windows/amd64/toolbox

    מחליפים את VERSION בגרסה של MCP Toolbox. לדוגמה, v1.2.0.

  2. הופכים את הקובץ הבינארי לקובץ הפעלה:

    chmod +x toolbox

  3. מאמתים את ההתקנה:

    ./toolbox --version

כדי להגדיר את ארגז הכלים באמצעות קובץ אימג' של קונטיינר או Homebrew, אפשר לעיין בדף Install Toolbox.

הגדרת לקוחות וחיבורים

בקטע הזה מוסבר איך לקשר את Cloud Storage לכלים שלכם אחרי שמתקינים את MCP Toolbox.

Claude code

  1. מתקינים את Claude Code.
  2. יוצרים קובץ .mcp.json בתיקיית הבסיס של הפרויקט, אם הוא לא קיים.
  3. מוסיפים את ההגדרה, מחליפים את הערכים הזמניים לשמירת מקום בערכים שלכם ושומרים:
    ‫
            {
          "mcpServers": {
            "storage": {
              "command": "./PATH/TO/toolbox",
              "args": ["--prebuilt","cloud-storage","--stdio"],
              "env": {
                "CLOUD_STORAGE_PROJECT": "PROJECT_ID"
              }
            }
          }
        }
    מחליפים את המשתנים הבאים בערכים שלכם:
    • ‫./PATH/TO/toolbox: הנתיב לקובץ הבינארי toolbox.
    • ‫CLOUD_STORAGE_PROJECT: משתנה הסביבה שמציין את מזהה הפרויקט ב- Google Cloud .
    • ‫PROJECT_ID: מזהה הפרויקט ב- Google Cloud .
  4. מפעילים מחדש את Claude Code כדי לטעון את ההגדרות החדשות. כשפותחים מחדש את Claude Code, האפליקציה מזהה את שרת ה-MCP שהוגדר.

‫Claude למחשב

  1. פותחים את Claude Desktop ועוברים אל הגדרות.
  2. בכרטיסייה Developer (פיתוח), לוחצים על Edit Config (עריכת ההגדרות) כדי לפתוח את קובץ ההגדרות.
  3. מוסיפים את ההגדרה, מחליפים את הערכים הזמניים לשמירת מקום בערכים שלכם ושומרים:
    ‫
            {
          "mcpServers": {
            "storage": {
              "command": "./PATH/TO/toolbox",
              "args": ["--prebuilt","cloud-storage","--stdio"],
              "env": {
                "CLOUD_STORAGE_PROJECT": "PROJECT_ID"
              }
            }
          }
        }
    מחליפים את המשתנים הבאים בערכים שלכם:
    • ‫./PATH/TO/toolbox: הנתיב לקובץ הבינארי toolbox.
    • ‫CLOUD_STORAGE_PROJECT: משתנה הסביבה שמציין את מזהה הפרויקט ב- Google Cloud .
    • ‫PROJECT_ID: מזהה הפרויקט ב- Google Cloud .
  4. מפעילים מחדש את Claude Desktop.
  5. במסך הצ'אט החדש מוצג סמל של פטיש (MCP) עם שרת ה-MCP החדש.

קלין

  1. פותחים את התוסף Cline ב-VS Code ולוחצים על הסמל MCP Servers.
  2. לוחצים על Configure MCP Servers (הגדרת שרתי MCP) כדי לפתוח את קובץ ההגדרות.
  3. מוסיפים את ההגדרה הבאה, מחליפים את הערכים הזמניים לשמירת מקום בערכים שלכם ושומרים:
    ‫
            {
          "mcpServers": {
            "storage": {
              "command": "./PATH/TO/toolbox",
              "args": ["--prebuilt","cloud-storage","--stdio"],
              "env": {
                "CLOUD_STORAGE_PROJECT": "PROJECT_ID"
              }
            }
          }
        }
    מחליפים את המשתנים הבאים בערכים שלכם:
    • ‫./PATH/TO/toolbox: הנתיב לקובץ הבינארי toolbox.
    • ‫CLOUD_STORAGE_PROJECT: משתנה הסביבה שמציין את מזהה הפרויקט ב- Google Cloud .
    • ‫PROJECT_ID: מזהה הפרויקט ב- Google Cloud .

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

סמן

  1. אם התיקייה .cursor לא קיימת, יוצרים אותה בתיקיית הבסיס של הפרויקט.
  2. יוצרים את הקובץ .cursor/mcp.json אם הוא לא קיים ופותחים אותו.
  3. מוסיפים את ההגדרה הבאה, מחליפים את הערכים הזמניים לשמירת מקום בערכים שלכם ושומרים:
    ‫
            {
          "mcpServers": {
            "storage": {
              "command": "./PATH/TO/toolbox",
              "args": ["--prebuilt","cloud-storage","--stdio"],
              "env": {
                "CLOUD_STORAGE_PROJECT": "PROJECT_ID"
              }
            }
          }
        }
    מחליפים את המשתנים הבאים בערכים שלכם:
    • ‫./PATH/TO/toolbox: הנתיב לקובץ הבינארי toolbox.
    • ‫CLOUD_STORAGE_PROJECT: משתנה הסביבה שמציין את מזהה הפרויקט ב- Google Cloud .
    • ‫PROJECT_ID: מזהה הפרויקט ב- Google Cloud .
  4. פותחים את Cursor ועוברים אל Settings > Cursor Settings > MCP. כשמתבצע חיבור לשרת, מופיע סטטוס פעיל בצבע ירוק.

קוד Visual Studio ‏ (Copilot)

  1. פותחים את VS Code ויוצרים את הספרייה .vscode בתיקיית הבסיס של הפרויקט, אם היא לא קיימת.
  2. יוצרים את הקובץ .vscode/mcp.json אם הוא לא קיים, ופותחים אותו.
  3. מוסיפים את ההגדרה הבאה, מחליפים את הערכים הזמניים לשמירת מקום בערכים שלכם ושומרים:
    ‫
            {
          "mcpServers": {
            "storage": {
              "command": "./PATH/TO/toolbox",
              "args": ["--prebuilt","cloud-storage","--stdio"],
              "env": {
                "CLOUD_STORAGE_PROJECT": "PROJECT_ID"
              }
            }
          }
        }
    מחליפים את המשתנים הבאים בערכים שלכם:
    • ‫./PATH/TO/toolbox: הנתיב לקובץ הבינארי toolbox.
    • ‫CLOUD_STORAGE_PROJECT: משתנה הסביבה שמציין את מזהה הפרויקט ב- Google Cloud .
    • ‫PROJECT_ID: מזהה הפרויקט ב- Google Cloud .
  4. טוענים מחדש את החלון של VS Code. התוסף שתואם ל-MCP מזהה באופן אוטומטי את ההגדרה ומפעיל את השרת.

גלישת רוח

  1. פותחים את Windsurf ועוברים אל Cascade assistant.
  2. לוחצים על סמל ה-MCP ואז על Configure (הגדרה) כדי לפתוח את קובץ ההגדרות.
  3. מוסיפים את ההגדרה הבאה, מחליפים את הערכים הזמניים לשמירת מקום בערכים שלכם ושומרים:
    ‫
            {
          "mcpServers": {
            "storage": {
              "command": "./PATH/TO/toolbox",
              "args": ["--prebuilt","cloud-storage","--stdio"],
              "env": {
                "CLOUD_STORAGE_PROJECT": "PROJECT_ID"
              }
            }
          }
        }
    מחליפים את המשתנים הבאים בערכים שלכם:
    • ‫./PATH/TO/toolbox: הנתיב לקובץ הבינארי toolbox.
    • ‫CLOUD_STORAGE_PROJECT: משתנה הסביבה שמציין את מזהה הפרויקט ב- Google Cloud .
    • ‫PROJECT_ID: מזהה הפרויקט ב- Google Cloud .

כלים מוכנים מראש

אחרי שמקשרים את MCP Toolbox ל-Cloud Storage, הסוכן משתמש בכלים הבאים שנוצרו מראש:

  • ‫list_buckets: הצגת רשימה של קטגוריות Cloud Storage בפרויקט שהוגדר.
  • ‫list_objects: הצגת רשימה של אובייקטים בקטגוריה עם סינון אופציונלי לפי תחילית ותו מפריד.
  • ‫get_bucket_metadata: מחזירה מטא-נתונים של קטגוריה.
  • ‫get_bucket_iam_policy: מחזירה את הקישורים למדיניות ה-IAM של קטגוריה.
  • ‫get_object_metadata: מחזירה מטא-נתונים של אובייקט.
  • ‫read_object: קוראת אובייקט טקסט בקידוד UTF-8 (או טווח בייטים). הגודל המקסימלי הוא 8MB, ואובייקטים בינאריים נדחים.
  • ‫download_object: הורדה של אובייקט לנתיב מקומי.
  • ‫create_bucket: יוצר קטגוריה בפרויקט שהוגדר.
  • ‫delete_bucket: מחיקת קטגוריה ריקה.
  • ‫upload_object: מעלה קובץ מקומי לאובייקט.
  • ‫write_object: כתיבת תוכן טקסט ישירות לאובייקט.
  • ‫copy_object: מעתיקה אובייקט לאובייקט יעד.
  • ‫move_object: משנה את השם של אובייקט באותה קטגוריה באופן אטומי.
  • ‫delete_object: מחיקת אובייקט.