Erste Schritte

Version 0.4.0 bietet 42 Werkzeuge in einer ausführbaren Datei, nutzbar im Terminal oder über einen MCP-Client. Dieses Handbuch beschreibt Installation, Google-Zugang und die vollständige Werkzeugschnittstelle.

Im lokalen Repository:

cargo install --path . --locked

Installation

Vorgefertigte Binärdateien für Linux x86_64, macOS Apple Silicon und macOS Intel finden Sie unter GitHub Releases. Laden Sie das passende Archiv herunter, prüfen Sie es anhand von SHA256SUMS, entpacken Sie es und legen Sie mcp-gmap-rs in Ihrem PATH ab. Die Linux-Binärdateien benötigen glibc 2.35 oder neuer. Die macOS-Binärdateien sind weder signiert noch notarisiert.

Mit Rust 1.88 oder neuer installieren Sie das Programm über crates.io:

cargo install mcp-gmap-rs --version 0.4.0 --locked
mcp-gmap-rs --version

Nach dem Kompilieren wird keine Rust-, Python- oder JavaScript-Laufzeit benötigt. Der Host benötigt CA-Zertifikate, DNS und ausgehenden HTTPS-Zugriff auf Google.

Zugriff konfigurieren

Erstellen Sie einen eingeschränkten Schlüssel und aktivieren Sie die Dienste, oder richten Sie OAuth mit einem Dienstkonto ein. Speichern Sie Zugangsdaten in einer von Git ignorierten .env im Arbeitsverzeichnis:

GOOGLE_MAPS_AUTH_MODE=api-key
GOOGLE_MAPS_API_KEY=your-restricted-api-key

Umgebungsvariablen überschreiben die Datei. Halten Sie Zugangsdaten aus der Versionsverwaltung und aus Image-Schichten heraus. Das Arbeitsverzeichnis ist entscheidend: Übergeordnete Verzeichnisse werden nicht nach .env durchsucht.

Erkunden, prüfen, aufrufen

Werkzeugerkennung und Offline-Diagnose stellen keine Google-Anfragen:

mcp-gmap-rs tools
mcp-gmap-rs schema search-places
mcp-gmap-rs doctor

Führen Sie anschließend Ihren ersten möglicherweise kostenpflichtigen Aufruf aus:

mcp-gmap-rs search-places --query 'coffee near Gare de Lyon, Paris'

Das Ergebnis ist JSON. Bewahren Sie zurückgegebene Orts-IDs für spätere Detailabfragen auf, statt dieselben Namen wiederholt aufzulösen. Lesen Sie CLI-Nutzung für Automatisierung oder MCP-Integration, um einen Agenten anzubinden. Rezepte zeigen kombinierte Abläufe; die vollständige Referenz beschreibt jeden Parameter, Standardwert und Ergebnistyp.