Zestaw narzędzi Google Maps Platform Code Assist

Opis

Zestaw narzędzi Google Maps Platform Code Assist 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, przez 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

Dostarczone 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 przeszukuje najnowsze wersje oficjalnej dokumentacji, samouczków i przykładowych kodów Google Maps Platform, aby zwracać odpowiedni kontekst do AI, która generuje dokładną odpowiedź.

Obsługiwane protokoły 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.

Wykorzystanie

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 jest 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 serwer MCP Code Assist jako rozszerzenie interfejsu wiersza poleceń Gemini:

     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 program Cursor, kliknij tutaj, aby zainstalować bezpośrednio usługę Google Maps Platform Code Assist MCP.
   • 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 Code Assist MCP
   • 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 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. Instalowanie 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 jeszcze raz naciśnij ENTER, 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 narzędzia oraz warunki korzystania znajdziesz w pliku README w repozytorium GitHub.