Google Maps Platform Code Assist-Toolkit

Beschreibung

Das Google Maps Platform Code Assist-Toolkit ist ein MCP-Server (Model Context Protocol), der die Antworten von Large Language Models (LLMs) verbessert, die für die Entwicklung von Anwendungen mit der Google Maps Platform verwendet werden. Dazu werden die Antworten in der offiziellen, aktuellen Dokumentation und in Codebeispielen verankert.

Da der MCP-Server auf die Inhalte zugreift, wenn das Modell aufgefordert wird, muss der Kontext des LLM in Bezug auf die Google Maps Platform nicht auf die Daten beschränkt sein, die zum Trainingsdatum des Modells verfügbar waren.

Zu den Google Maps Platform-Ressourcen, auf die der MCP-Server zugreifen kann, gehören:

Dokumentation zur Google Maps Platform
Nutzungsbedingungen für die Google Maps Platform
Google Maps Platform Trust Center
Code-Repositories in offiziellen GitHub-Organisationen der Google Maps Platform

Bereitgestellte Tools

Der MCP-Server stellt die folgenden Tools für KI-Clients bereit:

retrieve-instructions: Ein Hilfstool, das vom Client verwendet wird, um wichtige Systemanweisungen dazu zu erhalten, wie die Nutzerabsicht am besten interpretiert und effektive Aufrufe an das Tool retrieve-google-maps-platform-docs formuliert werden.
retrieve-google-maps-platform-docs: Das primäre Tool. Es nimmt eine Abfrage in natürlicher Sprache entgegen und sendet sie an eine gehostete RAG-Engine (Retrieval Augmented Generation). Die RAG-Engine sucht nach aktuellen Versionen der offiziellen Google Maps Platform-Dokumentation, Tutorials und Codebeispielen und gibt relevanten Kontext an die KI zurück, um eine genaue Antwort zu generieren.

Unterstützte MCP-Transports

Dieser Server unterstützt zwei Standard-MCP-Kommunikationsprotokolle:

stdio: Dies ist der Standardtransport, der verwendet wird, wenn ein Client den Server über einen command aufruft. Die Kommunikation erfolgt über die Standard-Ein-/Ausgabestreams und ist daher ideal für die lokale Befehlszeilenausführung.
Streamable HTTP: Der Server stellt einen /mcp-Endpunkt bereit, der POST-Anfragen akzeptiert. Dieser wird von Clients verwendet, die eine Verbindung über eine url herstellen, und ist der Standard für Remote-Serververbindungen. Unsere Implementierung unterstützt Streaming für interaktive Antworten in Echtzeit.

Nutzung

Sie können den Code Assist MCP-Server entweder auf Ihrem lokalen Entwicklungscomputer oder remote in Google Cloud Run ausführen.

Voraussetzungen

Um das Google Maps Platform Code Assist-Toolkit verwenden zu können, benötigen Sie eine Umgebung mit Node.js (LTS-Version empfohlen) und npm, um den Server zu klonen und auszuführen, sowie einen MCP-Client, um auf den Server zuzugreifen.

Code Assist als lokalen MCP-Server mit `stdio`-Transport verwenden (empfohlen)

Führen Sie den Server auf Ihrem lokalen Computer aus und verbinden Sie Clients über das stdio-Protokoll zur Verwendung mit KI-gestützten IDEs (z. B. VS Code, Android Studio, Cursor) oder KI-Desktopanwendungen (z. B. Gemini CLI). Dies ist die einfachste und häufigste Einrichtung.

Client konfigurieren

Fügen Sie den Server der MCP-Konfigurationsdatei Ihres bevorzugten KI-Clients hinzu. Unten finden Sie spezifische, geprüfte Anleitungen für Ihren Client.

Gemini Code Assist & Gemini CLI
- Option 1: Fügen Sie den Server direkt über die Befehlszeile hinzu (vorausgesetzt, Sie haben Gemini CLI bereits installiert):
```
 gemini mcp add google-maps-platform-code-assist npx -y @googlemaps/code-assist-mcp@latest
```
  - Prüfen Sie die Installation mit dem Befehl gemini mcp list.
- Option 2: Installieren Sie den Code Assist MCP-Server als Gemini CLI-Erweiterung:
```
gemini extensions install https://github.com/googlemaps/platform-ai.git
```
- Option 3: Fügen Sie die MCP-Serverkonfiguration manuell der Datei ~/.gemini/settings.json hinzu.
```
{
  "mcpServers": {
    "google-maps-platform-code-assist": {
      "command": "npx",
      "args": ["-y", "@googlemaps/code-assist-mcp@latest"]
    }
  }
}
```
Claude Code
- Option 1: Fügen Sie den Server direkt über die Befehlszeile hinzu (vorausgesetzt, Sie haben Claude Code bereits installiert):
```
    claude mcp add google-maps-platform-code-assist -- npx -y @googlemaps/code-assist-mcp@latest
```
  - Prüfen Sie die Installation mit dem Befehl claude mcp list.
  - Windows-Nutzer:Unter nativem Windows (nicht WSL) müssen Sie den Wrapper cmd /c für npx-Befehle verwenden, damit sie korrekt funktionieren.
```
claude mcp add google-maps-platform-code-assist -- cmd /c "npx -y @googlemaps/code-assist-mcp@latest"
```
- Option 2: Fügen Sie den Server manuell der Claude-Konfigurationsdatei ~/.claude.json hinzu.
```
"mcpServers": {
    "google-maps-platform-code-assist": {
      "command": "npx",
      "args": [
        "-y", "@googlemaps/code-assist-mcp@latest"
      ]
    }
  }
```
Cursor
- <-- Wenn Sie Cursor bereits installiert haben, klicken Sie hier, um den Google Maps Platform Code Assist MCP direkt zu installieren.
- Andernfalls fügen Sie ihn der Datei .cursor-settings/mcp.json Ihres Arbeitsbereichs hinzu.
```
{
  "mcpServers": {
    "google-maps-platform-code-assist": {
      "command": "npx",
      "args": ["-y", "@googlemaps/code-assist-mcp@latest"]
    }
  }
}
```

Firebase Studio

mit installiertem Code Assist MCP
Fügen Sie die Datei mcp.json im Ordner .idx Ihres Firebase Studio-Arbeitsbereichs hinzu.

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

Android Studio
- Erstellen Sie eine Datei mcp.json und platzieren Sie sie im Konfigurationsverzeichnis von Android Studio. Fügen Sie den Code Assist-Server der Liste hinzu:
```
{
  "mcpServers": {
    "google-maps-platform-code-assist": {
      "command": "npx",
      "args": ["-y", "@googlemaps/code-assist-mcp@latest"]
    }
  }
}
```
Cline
- Option 1: Installation über die Cline MCP-GUI
- Option 2: Manuelle oder programmatische Installation über die Cline MCP-Konfigurationsdatei. Die Konfigurationsdatei befindet sich unter:
  - 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
  - Fügen Sie der MCP-Konfiguration in cline_mcp_settings.json Folgendes hinzu:
```
{
  "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
- Option 1: Installation über die Roo MCP-GUI
- Option 2: Manuelle oder programmatische Installation über die Roo Code-Konfigurationsdatei. Die Konfigurationsdatei befindet sich unter:
  - 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
  - Fügen Sie der MCP-Konfiguration in mcp_settings.json Folgendes hinzu:
```
{
  "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
- Klicken Sie im Agentenmodus auf „Tools“ und dann in der Kopfzeile auf „Tools konfigurieren“ und dann auf „Über einen NPM-Paketnamen installieren“ (siehe Screenshots unten).
- Geben Sie den Paketnamen @googlemaps/code-assist-mcp ein und drücken Sie die Eingabetaste. Akzeptieren Sie die Installation und verwenden Sie den Standardport 3000. Drücken Sie dann noch einmal die Eingabetaste, um die Änderung zu bestätigen.
Windsurf
- Ähnlich wie bei der Anleitung für Cursor oben.
Kilo Code
- Ähnlich wie bei der Anleitung für Cline und Roo Code oben.