שימוש ב-Spanner עם MCP Toolbox for Databases,‏ Gemini CLI וסוכנים אחרים

במאמר הזה מוסבר איך לחבר את מופע Spanner לכלים שונים למפתחים שתומכים ב-Model Context Protocol‏ (MCP).

מומלץ להשתמש בתוסף הייעודי של Spanner ל-Gemini CLI. התוסף כולל את הכישורים הבסיסיים ישירות בתוסף, מה שמפשט את ההגדרה והקביעה של ההגדרות. אתם יכולים להגדיר את Gemini Code Assist כך שישתמש ב-Gemini CLI, וליהנות מיתרונות דומים בהגדרה בסביבת הפיתוח המשולבת (IDE). מידע נוסף זמין במאמר תוסף ל-Gemini CLI‏ – Spanner.

לחלופין, אפשר להתחבר באמצעות MCP Toolbox for Databases לסביבות פיתוח משולבות (IDE) ולכלי פיתוח אחרים שתומכים ב-MCP. ‫MCP Toolbox הוא שרת MCP בקוד פתוח שנועד לחבר סוכני AI לנתונים שלכם. הוא מטפל במשימות כמו אימות ואיגום חיבורים, ומאפשר לכם ליצור אינטראקציה עם הנתונים שלכם בשפה טבעית ישירות מסביבת הפיתוח המשולבת.

שימוש בתוסף ל-Gemini CLI ב-Spanner

השילוב של Spanner עם Gemini CLI מתבצע באמצעות תוסף קוד פתוח שמציע יכולות נוספות בהשוואה לחיבור הרגיל של MCP Toolbox. התוסף מציע תהליך התקנה יעיל וסט מיומנויות שמבוסס על כלי MCP. אם אתם משתמשים בתוסף ל-Gemini CLI, אתם לא צריכים להתקין את MCP Toolbox. מידע נוסף זמין במאמר תוסף ל-Gemini CLI – Spanner.

התוסף spanner כולל מיומנויות לרישום טבלאות ולהרצת הצהרות SQL ו-SQL DQL.

רשימה של כל המיומנויות הזמינות מופיעה במיומנויות Spanner ב-GitHub.

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

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

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

הגדרת מכונת Spanner

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

  2. יוצרים או בוחרים מכונה ומסד נתונים של Spanner.

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

    • קורא מסדי נתונים ב-Cloud Spanner‏ (roles/spanner.databaseReader) כדי להריץ שאילתות DQL ולרשום טבלאות.

    • משתמש במסד נתונים של Cloud Spanner‏ (roles/spanner.databaseUser) כדי להריץ שאילתות DML.

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

התקנה של MCP Toolbox

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

    ‫linux/amd64

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

    darwin/arm64

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

    darwin/amd64

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

    windows/amd64

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

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

    chmod +x toolbox

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

    ./toolbox --version

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

בקטע הזה מוסבר איך להגדיר כלי פיתוח שונים כדי להתחבר למופע Spanner. בוחרים את הלקוח מבין האפשרויות הבאות:

Gemini CLI

  1. מתקינים את Gemini CLI.
  2. כדי להתקין את התוסף Spanner ל-Gemini CLI ממאגר GitHub, מריצים את הפקודה הבאה: 
    gemini extensions install https://github.com/gemini-cli-extensions/spanner
  3. מגדירים את משתני הסביבה הבאים כדי להתחבר למופע Spanner: 
    export SPANNER_PROJECT="PROJECT_ID"
export SPANNER_INSTANCE="INSTANCE_NAME"
export SPANNER_DATABASE="DATABASE_NAME"
export SPANNER_DIALECT="DIALECT_NAME"
     מחליפים את מה שכתוב בשדות הבאים:
    • ‫PROJECT_ID: מזהה הפרויקט ב- Google Cloud .
    • ‫INSTANCE_NAME: שם מכונת Spanner.
    • ‫DATABASE_NAME: שם מסד הנתונים של Spanner.
    • ‫DIALECT_NAME: ניב ה-SQL של Spanner. מקבלים googlesql או postgresql. אם לא מוגדר ערך, ברירת המחדל היא googlesql.
  4. מפעילים את Gemini CLI במצב אינטראקטיבי: 
    gemini

    ממשק ה-CLI טוען באופן אוטומטי את התוסף Spanner ל-Gemini CLI ואת היכולות שלו, שבהן אפשר להשתמש כדי ליצור אינטראקציה עם מסד הנתונים.

    ב-Gemini CLI, משתמשים בפקודה /extensions כדי לוודא שהתוסף מותקן.

Gemini Code Assist

מומלץ מאוד להגדיר את Gemini Code Assist לשימוש ב-Gemini CLI, כי בגישה הזו לא צריך להגדיר שרת MCP באופן ידני. עם זאת, ההוראות להגדרת שרת MCP באופן ידני עדיין זמינות בקטע הבא:


1. מתקינים את התוסף Gemini Code Assist ב-VS Code.
‫2. מפעילים את מצב הסוכן ומחליפים את מודל הסוכן ל-Gemini.
3. בתיקיית השורש של הפרויקט, יוצרים תיקייה בשם .gemini ובתוכה קובץ settings.json.
4. מוסיפים לקובץ settings.json אחת מההגדרות הבאות, בהתאם לדיאלקט Spanner שבו אתם משתמשים.
‫5. מחליפים את המשתנים הבאים בערכים שלכם:
  • ‫PROJECT_ID: מזהה הפרויקט ב- Google Cloud .
  • ‫INSTANCE_NAME: השם של מכונת Spanner.
  • ‫DATABASE_NAME: השם של מסד הנתונים של Spanner.
‫6. שומרים את הקובץ.‫

Spanner עם ניב השפה GoogleSQL:

‫
{
  "mcpServers": {
    "spanner": {
      "command": "./PATH/TO/toolbox",
      "args": ["--prebuilt","spanner","--stdio"],
      "env": {
          "SPANNER_PROJECT": "PROJECT_ID",
          "SPANNER_INSTANCE": "INSTANCE_NAME",
          "SPANNER_DATABASE": "DATABASE_NAME"
      }
    }
  }
}

‫Spanner עם ניב PostgreSQL: 

{
  "mcpServers": {
    "spanner": {
      "command": "./PATH/TO/toolbox",
      "args": ["--prebuilt","spanner-postgres","--stdio"],
      "env": {
          "SPANNER_PROJECT": "PROJECT_ID",
          "SPANNER_INSTANCE": "INSTANCE_NAME",
          "SPANNER_DATABASE": "DATABASE_NAME"
      }
    }
  }
}

Claude Code

  1. מתקינים את Claude Code.
  2. מגדירים את משתני הסביבה כדי להתחבר למופע Spanner: 
    export SPANNER_PROJECT="PROJECT_ID"
export SPANNER_INSTANCE="INSTANCE_NAME"
export SPANNER_DATABASE="DATABASE_NAME"
export SPANNER_DIALECT="DIALECT_NAME"
     מחליפים את מה שכתוב בשדות הבאים:
    • ‫PROJECT_ID: מזהה הפרויקט ב- Google Cloud .
    • ‫INSTANCE_NAME: שם מכונת Spanner.
    • ‫DATABASE_NAME: שם מסד הנתונים של Spanner.
    • ‫DIALECT_NAME: ניב ה-SQL של Spanner. מקבלים googlesql או postgresql. אם לא מוגדר ערך, ברירת המחדל היא googlesql.
  3. מפעילים את הסוכן: 
    claude
  4. מתקינים את הפלאגין: 
    /plugin install spanner@claude-plugins-official

Codex

  1. מתקינים את Data Agent Kit Marketplace: 
    codex plugin marketplace add GoogleCloudPlatform/data-agent-kit
  2. מתקינים את הפלאגין Spanner: 
    codex plugin install spanner@data-agent-kit
  3. מגדירים את משתני הסביבה כדי להתחבר למופע Spanner: 
    export SPANNER_PROJECT="PROJECT_ID"
export SPANNER_INSTANCE="INSTANCE_NAME"
export SPANNER_DATABASE="DATABASE_NAME"
export SPANNER_DIALECT="DIALECT_NAME"
     מחליפים את מה שכתוב בשדות הבאים:
    • ‫PROJECT_ID: מזהה הפרויקט ב- Google Cloud .
    • ‫INSTANCE_NAME: שם מכונת Spanner.
    • ‫DATABASE_NAME: שם מסד הנתונים של Spanner.
    • ‫DIALECT_NAME: ניב ה-SQL של Spanner. מקבלים googlesql או postgresql. אם לא מוגדר ערך, ברירת המחדל היא googlesql.
  4. זה שינוי אופציונלי. עדכון ה-Marketplace: 
    codex plugin marketplace upgrade data-agent-kit

Claude למחשב


1. פותחים את Claude למחשב ועוברים אל הגדרות.
‫2. בכרטיסייה Developer (פיתוח), לוחצים על Edit Config (עריכת ההגדרה) כדי לפתוח את קובץ ההגדרה.
3. מוסיפים אחת מההגדרות הבאות בהתאם לדיאלקט של Spanner, מחליפים את משתני הסביבה בערכים שלכם ושומרים את הקובץ:

‫Spanner עם דיאלקט GoogleSQL:

‫
{
  "mcpServers": {
    "spanner": {
      "command": "./PATH/TO/toolbox",
      "args": ["--prebuilt","spanner","--stdio"],
      "env": {
          "SPANNER_PROJECT": "PROJECT_ID",
          "SPANNER_INSTANCE": "INSTANCE_NAME",
          "SPANNER_DATABASE": "DATABASE_NAME"
      }
    }
  }
}

‫Spanner עם ניב PostgreSQL: 

{
  "mcpServers": {
    "spanner": {
      "command": "./PATH/TO/toolbox",
      "args": ["--prebuilt","spanner-postgres","--stdio"],
      "env": {
          "SPANNER_PROJECT": "PROJECT_ID",
          "SPANNER_INSTANCE": "INSTANCE_NAME",
          "SPANNER_DATABASE": "DATABASE_NAME"
      }
    }
  }
}

4. מפעילים מחדש את Claude for Desktop.
‫5. במסך הצ'אט החדש מוצג סמל של פטיש (MCP) עם שרת ה-MCP החדש.

קלין


1. פותחים את התוסף Cline ב-VS Code ולוחצים על סמל MCP Servers.
‫2. מקישים על Configure MCP Servers (הגדרת שרתי MCP) כדי לפתוח את קובץ ההגדרות.
3. מוסיפים אחת מההגדרות הבאות בהתאם לדיאלקט Spanner, מחליפים את משתני הסביבה בערכים שלכם ושומרים את הקובץ:

‫Spanner עם דיאלקט GoogleSQL:

‫
{
  "mcpServers": {
    "spanner": {
      "command": "./PATH/TO/toolbox",
      "args": ["--prebuilt","spanner","--stdio"],
      "env": {
          "SPANNER_PROJECT": "PROJECT_ID",
          "SPANNER_INSTANCE": "INSTANCE_NAME",
          "SPANNER_DATABASE": "DATABASE_NAME"
      }
    }
  }
}

‫Spanner עם ניב PostgreSQL: 

{
  "mcpServers": {
    "spanner": {
      "command": "./PATH/TO/toolbox",
      "args": ["--prebuilt","spanner-postgres","--stdio"],
      "env": {
          "SPANNER_PROJECT": "PROJECT_ID",
          "SPANNER_INSTANCE": "INSTANCE_NAME",
          "SPANNER_DATABASE": "DATABASE_NAME"
      }
    }
  }
}

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

סמן


1. אם התיקייה .cursor לא קיימת, יוצרים אותה בתיקיית הבסיס של הפרויקט.
‫2. יוצרים את הקובץ .cursor/mcp.json אם הוא לא קיים ופותחים אותו.
3. מוסיפים אחת מההגדרות הבאות בהתאם לדיאלקט Spanner, מחליפים את משתני הסביבה בערכים שלכם ושומרים את הקובץ:

‫Spanner עם דיאלקט GoogleSQL:

‫
{
  "mcpServers": {
    "spanner": {
      "command": "./PATH/TO/toolbox",
      "args": ["--prebuilt","spanner","--stdio"],
      "env": {
          "SPANNER_PROJECT": "PROJECT_ID",
          "SPANNER_INSTANCE": "INSTANCE_NAME",
          "SPANNER_DATABASE": "DATABASE_NAME"
      }
    }
  }
}

‫Spanner עם ניב PostgreSQL: 

{
  "mcpServers": {
    "spanner": {
      "command": "./PATH/TO/toolbox",
      "args": ["--prebuilt","spanner-postgres","--stdio"],
      "env": {
          "SPANNER_PROJECT": "PROJECT_ID",
          "SPANNER_INSTANCE": "INSTANCE_NAME",
          "SPANNER_DATABASE": "DATABASE_NAME"
      }
    }
  }
}

4. פותחים את Cursor ועוברים אל Settings > Cursor Settings > MCP. כשמתבצע חיבור לשרת, מופיע סטטוס פעיל בצבע ירוק.

קוד Visual Studio ‏ (Copilot)


1. פותחים את VS Code ויוצרים את הספרייה .vscode בתיקיית הבסיס של הפרויקט, אם היא לא קיימת.
‫2. יוצרים את הקובץ .vscode/mcp.json אם הוא לא קיים, ופותחים אותו.
3. מוסיפים אחת מההגדרות הבאות בהתאם לדיאלקט Spanner, מחליפים את משתני הסביבה בערכים שלכם ושומרים את הקובץ:

‫Spanner עם דיאלקט GoogleSQL:

‫
{
  "servers": {
    "spanner": {
      "command": "./PATH/TO/toolbox",
      "args": ["--prebuilt","spanner","--stdio"],
      "env": {
        "SPANNER_PROJECT": "PROJECT_ID",
        "SPANNER_INSTANCE": "INSTANCE_NAME",
        "SPANNER_DATABASE": "DATABASE_NAME"
      }
    }
  }
}

‫Spanner עם ניב PostgreSQL: 

{
  "servers": {
    "spanner": {
      "command": "./PATH/TO/toolbox",
      "args": ["--prebuilt","spanner-postgres","--stdio"],
      "env": {
        "SPANNER_PROJECT": "PROJECT_ID",
        "SPANNER_INSTANCE": "INSTANCE_NAME",
        "SPANNER_DATABASE": "DATABASE_NAME"
      }
    }
  }
}

גלישת רוח


1. פותחים את Windsurf ועוברים אל Cascade assistant.
‫2. לוחצים על סמל ה-MCP ואז על Configure (הגדרה) כדי לפתוח את קובץ ההגדרות.
‫3. מוסיפים אחת מההגדרות הבאות בהתאם לדיאלקט של Spanner, מחליפים את משתני הסביבה בערכים שלכם ושומרים את הקובץ:

‫Spanner עם דיאלקט GoogleSQL:

‫
{
  "mcpServers": {
    "spanner": {
      "command": "./PATH/TO/toolbox",
      "args": ["--prebuilt","spanner","--stdio"],
      "env": {
          "SPANNER_PROJECT": "PROJECT_ID",
          "SPANNER_INSTANCE": "INSTANCE_NAME",
          "SPANNER_DATABASE": "DATABASE_NAME"
      }
    }
  }
}

‫Spanner עם ניב PostgreSQL: 

{
  "mcpServers": {
    "spanner": {
      "command": "./PATH/TO/toolbox",
      "args": ["--prebuilt","spanner-postgres","--stdio"],
      "env": {
          "SPANNER_PROJECT": "PROJECT_ID",
          "SPANNER_INSTANCE": "INSTANCE_NAME",
          "SPANNER_DATABASE": "DATABASE_NAME"
      }
    }
  }
}

התחברות ל-Antigravity

אפשר לחבר את Spanner ל-Antigravity בדרכים הבאות:

  • שימוש בחנות MCP
  • שימוש בהגדרה מותאמת אישית

חנות MCP

הדרך המומלצת ביותר להתחבר ל-Antigravity היא באמצעות חנות ה-MCP המובנית.

  1. פותחים את Antigravity ואת חלונית הסוכן של הכלי לעריכה.
  2. לוחצים על סמל התפריט בחלק העליון של החלונית ובוחרים באפשרות MCP Servers (שרתי MCP).
  3. ברשימת השרתים הזמינים, מאתרים את Spanner ולוחצים על Install (התקנה).
  4. פועלים לפי השלבים במסך כדי לאשר ל-Antigravity לגשת לפרויקט Google Cloud. כך Antigravity מקבל גישה למופע Spanner בפרויקט שלכם.

אחרי שמתקינים את שרת Spanner בחנות ה-MCP, המשאבים והמיומנויות מהשרת זמינים בכלי העריכה.

הגדרות אישיות

כדי להתחבר לשרת MCP בהתאמה אישית, מבצעים את השלבים הבאים:

  1. פותחים את Antigravity ואת חלונית הסוכן של הכלי לעריכה.
  2. לוחצים על סמל התפריט בחלק העליון של החלונית ובוחרים באפשרות MCP Servers (שרתי MCP).
  3. לוחצים על Manage MCP Servers > View raw config (ניהול שרתי MCP > הצגת הגדרות גולמיות) כדי לפתוח את הקובץ mcp_config.json.
  4. מוסיפים את ההגדרה הבאה, מחליפים את משתני הסביבה בערכים שלכם ושומרים.
{
  "mcpServers": {
    "spanner": {
      "command": "npx",
      "args": ["-y","@toolbox-sdk/server","--prebuilt","spanner","--stdio"],
      "env": {
          "SPANNER_PROJECT": "PROJECT_ID",
          "SPANNER_INSTANCE": "INSTANCE_NAME",
          "SPANNER_DATABASE": "DATABASE_NAME",
          "SPANNER_DIALECT": "DIALECT_NAME"
      }
    }
  }
}

אחרי שמגדירים את שרת ה-MCP המותאם אישית, המשאבים והמיומנויות משרת Spanner זמינים בעורך.

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

  • ‫PROJECT_ID: מזהה הפרויקט ב- Google Cloud .
  • ‫INSTANCE_NAME: השם של מכונת Spanner.
  • ‫DATABASE_NAME: השם של מסד הנתונים של Spanner.
  • ‫DIALECT_NAME: הניב של Spanner SQL. מקבלים googlesql או postgresql. אם לא מציינים ניב, ברירת המחדל היא googlesql.

התחברות ל-Spanner ב-VS Code באמצעות התוסף Data Agent Kit

התוסף Google Cloud Data Agent Kit מאפשר לכם לנהל את מסד הנתונים של Spanner ולהריץ שאילתות על נתוני Spanner בסביבת הפיתוח המשולבת (IDE) המועדפת עליכם. יש תמיכה ב-Visual Studio Code ובכל סביבות הפיתוח המשולבות (IDE) שמבוססות על VS Code.

התוסף הזה מספק יכולות של גילוי נתונים וחקירת נתונים, ומאפשר לכם לשאול שאלות לגבי הנתונים ב-Spanner בשפה טבעית. הוא עוזר למנוע מעבר הקשר בין כלי שורת הפקודה של Spanner לבין סביבת הפיתוח. ערכת Data Agent Kit מספקת גם תוספים ל-CLI שאפשר להשתמש בהם עם Google Cloud המשאבים.

מידע נוסף זמין במאמר סקירה כללית של התוסף Data Agent Kit ל-VS Code.