Zestaw narzędzi Google Maps Platform Code Assist

Opis

Zestaw narzędzi Code Assist w Google Maps Platform to serwer protokołu Model Context Protocol (MCP), który wzbogaca odpowiedzi dużych modeli językowych (LLM) używanych do tworzenia aplikacji z Google Maps Platform, poprzez grounding odpowiedzi z użyciem oficjalnej, aktualnej dokumentacji i przykładowych kodów.

Serwer MCP uzyskuje dostęp do treści, gdy model jest o to proszony, więc kontekst LLM dotyczący platformy Google Maps nie musi być ograniczony do danych dostępnych w dniu trenowania modelu.

Zasoby Google Maps Platform, do których serwer MCP może uzyskać dostęp, to:

• Dokumentacja Google Maps Platform
• Warunki korzystania z usługi Google Maps Platform
• Centrum zaufania Google Maps Platform
• Repozytoria kodu w oficjalnych organizacjach GitHub platformy Google Maps

Programiści

• 🪄 Spraw, aby Twój ulubiony asystent AI lub IDE stał się ekspertem w zakresie Google Maps Platform. Dzięki Code Assist agenci AI, tacy jak Gemini CLI, Claude Code i Cursor, mogą generować kod i odpowiadać na pytania programistów na podstawie aktualnej, oficjalnej dokumentacji i przykładowych kodów Google Maps Platform – bezpośrednio w procesie tworzenia oprogramowania.

• 🚀 Niezależnie od tego, czy wprowadzasz precyzyjne zmiany w kodzie przy pomocy AI, czy tworzysz prototyp nowej aplikacji, Code Assist pomoże Ci wykonać zadanie szybciej i łatwiej.

🔧 Dostępne narzędzia

Serwer MCP udostępnia klientom AI te narzędzia:

1. retrieve-instructions: narzędzie pomocnicze używane przez klienta do uzyskiwania kluczowych instrukcji systemowych dotyczących tego, jak najlepiej wnioskować o intencjach użytkownika i formułować skuteczne wywołania narzędzia retrieve-google-maps-platform-docs.
2. retrieve-google-maps-platform-docs: główne narzędzie. Przyjmuje zapytanie w języku naturalnym i przesyła je do hostowanego silnika generowania wspomaganego wyszukiwaniem (RAG). Silnik RAG wyszukuje najnowsze wersje oficjalnej dokumentacji, samouczków i przykładowych kodów Platformy Map Google, zwracając odpowiedni kontekst do AI, aby wygenerować dokładną odpowiedź.

🛠️ Obsługiwane protokoły transportowe MCP

Ten serwer obsługuje 2 standardowe protokoły komunikacji MCP:

• stdio: jest to domyślny transport używany, gdy klient wywołuje serwer za pomocą command. Komunikuje się za pomocą standardowych strumieni wejścia/wyjścia, dzięki czemu idealnie nadaje się do lokalnego wykonywania wiersza poleceń.
• Streamable HTTP: serwer udostępnia punkt końcowy /mcp, który akceptuje żądania POST. Jest on używany przez klientów, którzy łączą się za pomocą url, i jest standardem w przypadku połączeń z serwerami zdalnymi. Nasza implementacja obsługuje przesyłanie strumieniowe w przypadku interaktywnych odpowiedzi w czasie rzeczywistym.

🚀 Użycie

Serwer MCP Code Assist możesz uruchomić lokalnie na komputerze deweloperskim lub zdalnie w Google Cloud Run.

Wymagania

Aby korzystać z zestawu narzędzi Google Maps Platform Code Assist, musisz mieć środowisko z zainstalowanymi Node.js (zalecana wersja LTS) i npm, aby sklonować i uruchomić serwer, a także klienta MCP, aby uzyskać dostęp do serwera.

Używanie funkcji Code Assist jako lokalnego serwera MCP z transportem stdio (zalecane)

Uruchom serwer na komputerze lokalnym i połącz klientów za pomocą protokołu stdio, aby używać go w IDE z pomocą AI (takich jak VS Code, Android Studio, Cursor) lub w aplikacjach AI na komputery (takich jak Gemini CLI). Jest to najprostsza i najczęstsza konfiguracja.

Konfigurowanie klienta

Dodaj serwer do pliku konfiguracji MCP preferowanego klienta AI. Poniżej znajdź swojego klienta, aby uzyskać szczegółowe, sprawdzone instrukcje.

1. Gemini Code Assist i interfejs wiersza poleceń Gemini

   • Opcja 1. Dodaj serwer bezpośrednio z wiersza poleceń (zakładając, że masz już zainstalowany interfejs Gemini CLI):

      gemini mcp add google-maps-platform-code-assist npx -y @googlemaps/code-assist-mcp@latest
     

     • Sprawdź instalację, uruchamiając polecenie gemini mcp list.
   • Opcja 2. Zainstaluj Code Assist jako rozszerzenie interfejsu wiersza poleceń Gemini ze statycznym wstępem, narzędziem MCP i podstawowym motywem Map Google:

     gemini extensions install https://github.com/googlemaps/platform-ai.git
     

   • Opcja 3. Ręcznie dodaj konfigurację serwera MCP do pliku ~/.gemini/settings.json.

   {
     "mcpServers": {
       "google-maps-platform-code-assist": {
         "command": "npx",
         "args": ["-y", "@googlemaps/code-assist-mcp@latest"]
       }
     }
   }
   

2. Claude Code

   • Opcja 1. Dodaj serwer bezpośrednio z wiersza poleceń (zakładając, że masz już zainstalowany kod Claude):

         claude mcp add google-maps-platform-code-assist -- npx -y @googlemaps/code-assist-mcp@latest
     

     • Sprawdź instalację, uruchamiając polecenie claude mcp list.
     • Użytkownicy systemu Windows: w natywnym systemie Windows (nie WSL) musisz używać otoczki cmd /c dla poleceń npx, aby działały one prawidłowo.

     claude mcp add google-maps-platform-code-assist -- cmd /c "npx -y @googlemaps/code-assist-mcp@latest"
     

   • Opcja 2. Ręczne dodanie serwera do pliku konfiguracyjnego Claude ~/.claude.json

   "mcpServers": {
       "google-maps-platform-code-assist": {
         "command": "npx",
         "args": [
           "-y", "@googlemaps/code-assist-mcp@latest"
         ]
       }
     }
   

3. Kursor

   • <-- Jeśli masz już zainstalowany edytor Cursor, kliknij tutaj, aby zainstalować bezpośrednio MCP Code Assist w Google Maps Platform.
   • W przeciwnym razie dodaj ją do pliku .cursor-settings/mcp.json w obszarze roboczym.

   {
     "mcpServers": {
       "google-maps-platform-code-assist": {
         "command": "npx",
         "args": ["-y", "@googlemaps/code-assist-mcp@latest"]
       }
     }
   }
   

4. Firebase Studio

   • z zainstalowanym MCP Code Assist
   • Dodaj do pliku mcp.json w folderze .idx w obszarze roboczym Firebase Studio

   {
     "mcpServers": {
       "google-maps-platform-code-assist": {
         "command": "npx",
         "args": ["-y", "@googlemaps/code-assist-mcp@latest"]
       }
     }
   }
   

5. Android Studio

   • Utwórz plik mcp.json i umieść go w katalogu konfiguracji Android Studio. Dodaj serwer Code Assist do listy:

   {
     "mcpServers": {
       "google-maps-platform-code-assist": {
         "command": "npx",
         "args": ["-y", "@googlemaps/code-assist-mcp@latest"]
       }
     }
   }
   

6. Cline

   • Opcja 1. Instalacja za pomocą graficznego interfejsu użytkownika Cline MCP
   • Opcja 2. Ręczna lub programowa instalacja za pomocą pliku konfiguracyjnego Cline MCP. Plik konfiguracyjny znajduje się w tym miejscu:
     • 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
     • Dodaj do konfiguracji MCP w cline_mcp_settings.json te informacje:

       {
         "mcpServers": {
           "google-maps-platform-code-assist": {
             "command": "npx",
             "args": ["-y", "@googlemaps/code-assist-mcp@latest"],
             "alwaysAllow": [
               "retrieve-instructions",
               "retrieve-google-maps-platform-docs"
             ]
           }
         }
       }
       

7. Roo Code

   • Opcja 1. Instalacja za pomocą graficznego interfejsu użytkownika Roo MCP
   • Opcja 2. Ręczna lub programowa instalacja za pomocą pliku konfiguracyjnego Roo Code. Plik konfiguracyjny znajduje się w tym miejscu:
     • 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
     • Dodaj do konfiguracji MCP w mcp_settings.json te informacje:

       {
         "mcpServers": {
           "google-maps-platform-code-assist": {
             "command": "npx",
             "args": ["-y", "@googlemaps/code-assist-mcp@latest"],
             "alwaysAllow": [
               "retrieve-instructions",
               "retrieve-google-maps-platform-docs"
             ]            
           }
         }
       }
       

8. Microsoft Copilot

   • W trybie agenta kliknij „Narzędzia”, a potem w nagłówku u góry kliknij „Skonfiguruj narzędzia”, a następnie „Zainstaluj z nazwy pakietu NPM” (patrz zrzuty ekranu poniżej).

   • 
   • 
   • 

   • Wpisz nazwę pakietu @googlemaps/code-assist-mcp i naciśnij ENTER, aby zaakceptować instalację i użyć domyślnego portu 3000, a następnie naciśnij ENTER jeszcze raz, aby potwierdzić zmianę.

   • 

9. Windsurfing

   • Podobnie jak w przypadku instrukcji dotyczących kursora powyżej.

10. Kilo Code

    • Podobnie jak w przypadku instrukcji dotyczących kodu Cline i Roo powyżej

Więcej informacji

Więcej informacji o instalowaniu i używaniu tego zestawu narzędzi oraz warunki korzystania znajdziesz w pliku README w repozytorium GitHub.