Démarrage rapide

La version 0.4.0 propose 42 outils dans un seul exécutable, accessibles depuis le terminal ou un client MCP. Ce manuel décrit l’installation, l’accès à Google et l’interface complète des outils.

Depuis le dépôt cloné :

cargo install --path . --locked

Installer

Téléchargez l’archive correspondant à Linux x86_64, macOS Apple Silicon ou macOS Intel depuis les versions GitHub. Vérifiez son empreinte avec SHA256SUMS, extrayez-la et placez l’exécutable dans votre PATH. Sur macOS, les binaires ne sont pas signés ni notariés.

Avec Rust 1.88 ou une version plus récente :

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

Le système hôte doit disposer de certificats d’autorité valides et d’un accès HTTPS sortant vers Google.

Découvrir sans identifiants

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

tools, schema et l’aide ne contactent pas Google. doctor vérifie la configuration locale ; il peut échouer si les identifiants attendus manquent, sans effectuer de requête réseau.

Effectuer un premier appel

Créez une clé restreinte et activez les services nécessaires en suivant Google Cloud. Conservez-la dans un fichier .env non suivi par Git :

GOOGLE_MAPS_API_KEY=your-restricted-api-key

mcp-gmap-rs geocode --address 'Paris, France'

Cet appel réel peut être facturé. Le résultat JSON contient les coordonnées, l’adresse formatée et un identifiant de lieu. Choisissez ensuite votre interface : CLI, MCP ou conteneur/Kubernetes. Consultez la référence des outils pour les paramètres et limites exacts.