ערכת הכלים Google Maps Platform Code Assist

תיאור

ערכת הכלים Google Maps Platform Code Assist היא שרת Model Context Protocol ‏(MCP) שמשפר את התשובות של מודלים גדולים של שפה (LLM) שמשמשים לפיתוח אפליקציות בפלטפורמה של מפות Google. התשובות מעוגנות בתיעוד הרשמי והעדכני ובדוגמאות קוד.

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

המשאבים בפלטפורמה של מפות Google שהשרת של ה-MCP יכול לגשת אליהם כוללים:

מסמכי התיעוד בפלטפורמה של מפות Google
התנאים וההגבלות של הפלטפורמה של מפות Google
מרכז המהימנות של Google Maps Platform
מאגרי קוד בארגוני GitHub הרשמיים של הפלטפורמה של מפות Google

כלים שסופקו

שרת ה-MCP חושף את הכלים הבאים ללקוחות AI:

‫retrieve-instructions: כלי עזר שמשמש את הלקוח כדי לקבל הוראות מערכת חשובות לגבי הדרך הטובה ביותר להסיק מסקנות לגבי כוונת המשתמש ולנסח קריאות יעילות לכלי retrieve-google-maps-platform-docs.
‫retrieve-google-maps-platform-docs: הכלי הראשי. הוא מקבל שאילתה בשפה טבעית ושולח אותה למנוע Retrieval-Augmented Generation (יצירה משולבת-אחזור, RAG) שמתארח בשרת. מנוע ה-RAG מחפש גרסאות עדכניות של מסמכים רשמיים, מדריכים ודוגמאות קוד מהפלטפורמה של מפות Google, ומחזיר הקשר רלוונטי ל-AI כדי ליצור תשובה מדויקת.

פרוטוקולי תעבורה נתמכים של MCP

השרת הזה תומך בשני פרוטוקולי תקשורת סטנדרטיים של MCP:

‫stdio: זהו פרוטוקול התעבורה שמוגדר כברירת מחדל כשלקוח מפעיל את השרת באמצעות command. הוא מתקשר באמצעות זרמי הקלט/פלט הרגילים, ולכן הוא אידיאלי להרצה מקומית של שורת פקודה.
‫Streamable HTTP: השרת חושף נקודת קצה /mcp שמקבלת בקשות POST. הפרוטוקול הזה משמש לקוחות שמתחברים דרך url והוא הפרוטוקול הסטנדרטי לחיבורים לשרתים מרוחקים. ההטמעה שלנו תומכת בסטרימינג של תשובות אינטראקטיביות בזמן אמת.

שימוש

אתם יכולים להריץ את שרת ה-MCP של Code Assist במחשב הפיתוח המקומי שלכם או מרחוק ב-Google Cloud Run.

דרישות

כדי להשתמש בערכת הכלים Google Maps Platform Code Assist, צריך סביבה עם Node.js (מומלץ להשתמש בגרסת LTS) ו-npm מותקנים כדי לשכפל ולהפעיל את השרת, וגם לקוח MCP כדי לגשת לשרת.

שימוש ב-Code Assist כשרת MCP מקומי עם תעבורת `stdio` (מומלץ)

מריצים את השרת במחשב המקומי ומחברים לקוחות באמצעות פרוטוקול stdio לשימוש בסביבות פיתוח משולבות (IDE) עם תמיכה ב-AI (כמו VS Code, ‏Android Studio, ‏Cursor) או באפליקציות AI למחשב (כמו Gemini CLI). זו ההגדרה הפשוטה והנפוצה ביותר.

הגדרת הלקוח

מוסיפים את השרת לקובץ התצורה של MCP בלקוח ה-AI המועדף. בהמשך מופיעות הוראות ספציפיות ומאומתות לכל לקוח.

‫Gemini Code Assist ו-Gemini CLI
- אפשרות 1 – מוסיפים את השרת ישירות משורת הפקודה (בהנחה ש-Gemini CLI כבר מותקן):
```
 gemini mcp add google-maps-platform-code-assist npx -y @googlemaps/code-assist-mcp@latest
```
  - כדי לאמת את ההתקנה, מריצים את הפקודה gemini mcp list.
- אפשרות 2 – מתקינים את שרת ה-MCP של Code Assist כתוסף ל-Gemini CLI:
```
gemini extensions install https://github.com/googlemaps/platform-ai.git
```
- אפשרות 3 – מוסיפים את ההגדרות של שרת ה-MCP באופן ידני לקובץ ~/.gemini/settings.json.
```
{
  "mcpServers": {
    "google-maps-platform-code-assist": {
      "command": "npx",
      "args": ["-y", "@googlemaps/code-assist-mcp@latest"]
    }
  }
}
```
Claude Code
- אפשרות 1 – מוסיפים את השרת ישירות משורת הפקודה (בהנחה ש-Claude Code כבר מותקן):
```
    claude mcp add google-maps-platform-code-assist -- npx -y @googlemaps/code-assist-mcp@latest
```
  - כדי לאמת את ההתקנה, מריצים את הפקודה claude mcp list.
  - משתמשי Windows: ב-Windows מקורי (לא WSL), צריך להשתמש ב-wrapper‏ cmd /c כדי שפקודות npx יפעלו בצורה תקינה.
```
claude mcp add google-maps-platform-code-assist -- cmd /c "npx -y @googlemaps/code-assist-mcp@latest"
```
- אפשרות 2 – מוסיפים את השרת באופן ידני לקובץ התצורה של Claude ~/.claude.json
```
"mcpServers": {
    "google-maps-platform-code-assist": {
      "command": "npx",
      "args": [
        "-y", "@googlemaps/code-assist-mcp@latest"
      ]
    }
  }
```
Cursor
- ‫ <-- אם כבר התקנתם את Cursor, לחצו כאן כדי להתקין את Google Maps Platform Code Assist MCP ישירות.
- אם לא, הוסיפו אותו לקובץ .cursor-settings/mcp.json של סביבת העבודה.
```
{
  "mcpServers": {
    "google-maps-platform-code-assist": {
      "command": "npx",
      "args": ["-y", "@googlemaps/code-assist-mcp@latest"]
    }
  }
}
```
Firebase Studio
- עם Code Assist MCP מותקן
- מוסיפים לקובץ mcp.json של הפרויקט בתיקייה .idx בסביבת העבודה שלכם ב-Firebase Studio
```
{
  "mcpServers": {
    "google-maps-platform-code-assist": {
      "command": "npx",
      "args": ["-y", "@googlemaps/code-assist-mcp@latest"]
    }
  }
}
```
‫Android Studio
- יוצרים קובץ mcp.json וממקמים אותו בספריית ההגדרות של Android Studio. מוסיפים את השרת של Code Assist לרשימה:
```
{
  "mcpServers": {
    "google-maps-platform-code-assist": {
      "command": "npx",
      "args": ["-y", "@googlemaps/code-assist-mcp@latest"]
    }
  }
}
```
Cline
- אפשרות 1: מתקינים באמצעות Cline MCP GUI
- אפשרות 2: מטמיעים ידנית או באמצעות תוכנה עם קובץ התצורה Cline MCP. קובץ התצורה נמצא במיקום:
  - ‫macOS: ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
  - ‫Windows: %APPDATA%/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
  - ‫Linux: ~/.config/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
  - מוסיפים את ההגדרות הבאות לתצורת ה-MCP ב-cline_mcp_settings.json:
```
{
  "mcpServers": {
    "google-maps-platform-code-assist": {
      "command": "npx",
      "args": ["-y", "@googlemaps/code-assist-mcp@latest"],
      "alwaysAllow": [
        "retrieve-instructions",
        "retrieve-google-maps-platform-docs"
      ]
    }
  }
}
```
Roo Code
- אפשרות 1: מתקינים באמצעות Roo MCP GUI
- אפשרות 2: מתקינים ידנית או באמצעות תוכנה עם קובץ התצורה של Roo Code. קובץ התצורה נמצא במיקום:
  - ‫macOS: ~/Library/Application Support/Code/User/globalStorage/rooveterinaryinc.roo-cline/settings/mcp_settings.json
  - ‫Windows: %APPDATA%\Code\User\globalStorage\rooveterinaryinc.roo-cline\settings\mcp_settings.json
  - ‫Linux: ~/.config/Code/User/globalStorage/rooveterinaryinc.roo-cline/settings/mcp_settings.json
  - מוסיפים את ההגדרות הבאות לתצורת ה-MCP ב-mcp_settings.json:
```
{
  "mcpServers": {
    "google-maps-platform-code-assist": {
      "command": "npx",
      "args": ["-y", "@googlemaps/code-assist-mcp@latest"],
      "alwaysAllow": [
        "retrieve-instructions",
        "retrieve-google-maps-platform-docs"
      ]            
    }
  }
}
```
‫Microsoft Copilot
- במצב סוכן, לוחצים על Tools (כלים), ואז בכותרת העליונה לוחצים על Configure Tools (הגדרת כלים), ואז על Install from an NPM package name (התקנה משם חבילת NPM). ראו צילומי מסך בהמשך.
- מזינים את שם החבילה @googlemaps/code-assist-mcp ולוחצים על Enter כדי לאשר את ההתקנה ולהשתמש ביציאה 3000 שמוגדרת כברירת מחדל. לוחצים על Enter פעם נוספת כדי לאשר את השינוי.
Windsurf
- בדומה להוראות לגבי Cursor שלמעלה.
Kilo Code
- בדומה להוראות לגבי Cline ו-Roo Code שלמעלה