Addrova

Serveur MCP pour assistants IA

addrova-mcp est le serveur Model Context Protocol (MCP) officiel d'Addrova. Il expose l'API aux assistants compatibles MCP (Claude Desktop, Claude Code et autres clients) par le transport stdio. Tous les outils sont en lecture seule.

Outils

Outil Rôle
geocode(address, country?, limit?) Adresse en texte libre vers des candidats (latitude et longitude, précision, confiance)
reverse(lat, lon, limit?) Coordonnées vers l'adresse la plus proche
autocomplete(text, country?, limit?, lat?, lon?) Suggestions pour une saisie partielle
repair(address, country?) Corrige une adresse, champ par champ (facturée au succès)
coverage() Pays couverts, sources et licences, calibration

Chaque réponse contient une attribution (sources et licences) : citez-la avec les résultats.

Installation et configuration

Il n'est pas encore publié sur PyPI ; installez-le depuis le dépôt. [À VÉRIFIER : publication sur PyPI]

pip install ./sdk/python ./mcp
export ADDROVA_API_KEY=adr_live_…
addrova-mcp

Exemple de configuration client (Claude Desktop, claude_desktop_config.json) :

{
  "mcpServers": {
    "addrova": {
      "command": "addrova-mcp",
      "env": { "ADDROVA_API_KEY": "adr_live_…" }
    }
  }
}

La variable d'environnement ADDROVA_BASE_URL est facultative et vaut par défaut l'API de production.

À savoir avant de connecter un assistant

  • Le serveur s'appuie sur le SDK Python : les adresses circulent dans le corps des requêtes, aucune adresse n'est journalisée, et les erreurs ne renvoient à l'assistant que le code, le statut et l'identifiant de requête.
  • L'assistant envoie à l'API Addrova, avec votre clé, les adresses que vous lui donnez. Traitez-les comme des données personnelles, comme pour tout appel d'API.
  • Ce que l'API journalise et conserve est décrit sur la page conformité. Ces affirmations couvrent l'API ; ce que journalisent l'assistant, son fournisseur ou le client MCP n'en fait pas partie.
  • Gardez une clé distincte pour les assistants, pour pouvoir la révoquer ou la faire tourner depuis la console développeur sans toucher à vos clés de production.