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

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

תיאור

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

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

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

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

מפתחים

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

🔧 כלים שסופקו

שרת ה-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 – מתקינים את Code Assist כתוסף ל-Gemini CLI עם הקדמה סטטית, הכלי MCP ועיצוב בסיסי של מפות Google:
```
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 שמופיעות למעלה