דף זה תורגם על ידי Cloud Translation API.

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

תיאור

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

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

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

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

מפתחים

‫🪄 הופכים את העוזר הדיגיטלי מבוסס-AI או את סביבת הפיתוח המשולבת (IDE) האהובים עליכם למומחים ב-Google Maps Platform. בעזרת Code Assist, סוכני AI כמו Gemini CLI,‏ Claude Code ו-Cursor יכולים ליצור קוד ולענות על שאלות של מפתחים על סמך תיעוד ודוגמאות קוד עדכניים ורשמיים של Google Maps Platform – ישירות בתהליך העבודה שלכם.
‫🚀 בין אם אתם מבצעים שינויים מדויקים בקוד בעזרת AI או יוצרים אב טיפוס חדש של אפליקציה באמצעות vibecoding, Code Assist יכול לעזור לכם לבצע את המשימה מהר יותר ובקלות רבה יותר.

🔧 כלים שסופקו

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

‫retrieve-instructions: כלי עזר שהלקוח משתמש בו כדי לקבל הוראות מערכת חשובות לגבי הדרך הטובה ביותר להסיק מסקנות לגבי כוונת המשתמש ולנסח קריאות יעילות לכלי retrieve-google-maps-platform-docs.
‫retrieve-google-maps-platform-docs: הכלי הראשי. הוא מקבל שאילתה בשפה טבעית ושולח אותה למנוע RAG (אחזור משופר גנרטיבי) שמתארח בשרת. מנוע ה-RAG מחפש גרסאות עדכניות של מסמכי תיעוד, מדריכים ודוגמאות קוד רשמיים של Google Maps Platform, ומחזיר הקשר רלוונטי ל-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` transport (מומלץ)

מריצים את השרת במחשב המקומי ומחברים לקוחות באמצעות פרוטוקול 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 באופן ידני לקובץ ~/.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@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-mc@latest"
      ]
    }
  }
```
סמן
- ‫ <-- אם כבר התקנתם את 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
- אפשרות 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
- אפשרות 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
- במצב סוכן, לוחצים על 'כלים', ואז בכותרת העליונה לוחצים על 'הגדרת כלים', ואז על 'התקנה משם חבילת NPM' (ראו צילומי מסך בהמשך)
- מזינים את שם החבילה @googlemaps/code-assist-mcp ומקישים על Enter כדי לאשר את ההתקנה ולהשתמש ביציאה 3000 שמוגדרת כברירת מחדל. מקישים על Enter פעם נוספת כדי לאשר את השינוי.
גלישת רוח
- בדומה להוראות לגבי הסמן שלמעלה.
Kilo Code
- בדומה להוראות הקוד של Cline ו-Roo שמופיעות למעלה